NPGetCaps 関数 (npapi.h)

ネットワーク上でサポートされているサービスに関する情報を返します。

構文

DWORD NPGetCaps(
       DWORD ndex
);

パラメーター

ndex

戻り値

NPGetCaps 関数は、nIndex パラメーターの値に応じて定数またはビットマスクを返します。 nIndex 値の一部により、定数が返されます。 ただし、ほとんどの場合、 nIndex パラメーターはクエリを実行するサービスのセットを指定し、返される値は、このセット内のどのサービスがサポートされているかを示すビットマスクです。 このような場合、0 の戻り値は、セット内のどのサービスもサポートされていないことを示します。

次の一覧は 、nIndex に含まれる可能性がある値を示しています。その後に、その値に対して返される内容の説明が続きます。

####WNNC_ADMIN ネットワーク プロバイダーがサポートする管理機能を示すマスクを返します。 これには、次の 1 つ以上を指定できます。

####WNNC_CONNECTION ネットワーク プロバイダーがサポートする接続関数を示すマスクを返します。 これには、次の 1 つ以上を指定できます。

####WNNC_DIALOG ネットワーク プロバイダーがサポートするダイアログ ボックス関数を示すマスクを返します。 これには、次の 1 つ以上を指定できます。

####WNNC_ENUMERATION

サポートされている列挙型のスコープ (ある場合) を示すマスクを返します。 列挙スコープの詳細については、参照トピック NPOpenEnum の「パラメーター」セクションを参照してください。 これには、次の 1 つ以上を指定できます。

手記 WNNC_ENUMERATIONが 0 以外のビットマスクを返す場合は、ネットワーク プロバイダーが NPOpenEnum を サポートし、プロバイダーが NPEnumResource と NPCloseEnum もサポートしていることを推測できます。 これは、NPOpenEnum をサポートするネットワーク プロバイダーも NPEnumResource と NPCloseEnum をサポートすることが期待されるためです。

####WNNC_NET_TYPE ネットワーク プロバイダーがサポートするネットワークの種類を示す値を返します。 高い単語にはプロバイダーの種類が含まれており、下位の単語にはサブタイプが含まれている可能性があります。 新しいプロバイダーに取り組んでいる開発者は、Microsoft から新しいネットワークの種類を取得する必要があります。 正しいネットワークの種類を返さないプロバイダーは、WNET 関数が予期しない方法で動作する可能性があります。

ネットワークの種類は、次のいずれかになります。

• WNNC_NET_10NET
• WNNC_NET_INTERGRAPH
• WNNC_NET_3IN1
• WNNC_NET_LANMAN
• WNNC_NET_9TILES
• WNNC_NET_LANSTEP
• WNNC_NET_APPLETALK
• WNNC_NET_LANTASTIC
• WNNC_NET_AS400
• WNNC_NET_LIFENET
• WNNC_NET_BMC
• WNNC_NET_LOCUS
• WNNC_NET_BWNFS
• WNNC_NET_MASFAX
• WNNC_NET_CLEARCASE
• WNNC_NET_MSNET
• WNNC_NET_COGENT
• WNNC_NET_NETWARE
• WNNC_NET_CSC
• WNNC_NET_OBJECT_DIRE
• WNNC_NET_DCE
• WNNC_NET_PATHWORKS
• WNNC_NET_DECOREB
• WNNC_NET_POWERLAN
• WNNC_NET_DISTENCT
• WNNC_NET_PROTSTOR
• WNNC_NET_EXTENDNET
• WNNC_NET_RDR2SAMPLE
• WNNC_NET_FARALLON
• WNNC_NET_SHIVA
• WNNC_NET_FJ REDIR
• WNNC_NET_SUN_PC_NFS
• WNNC_NET_FRONTIER
• WNNC_NET_SYMFONET
• WNNC_NET_FTP_NFS
• WNNC_NET_TWINS
• WNNC_NET_HOB_NFS
• WNNC_NET_VINES
• WNNC_NET_IBMAL

####WNNC_SPEC_VERSION WNNC_SPEC_VERSION51を返します。 戻り値の上位と下位の単語には、資格情報マネージャーでサポートされている WNet API 仕様のメジャー バージョン番号とマイナー バージョン番号が含まれます。

####WNNC_START プロバイダーが起動する可能性が高いかどうかを示す次のいずれかの値を返します。 MPR は、すべてのネットワーク プロバイダーによって指定された最長のタイムアウト期間を待機します。

####WNNC_USER ネットワーク プロバイダーが NPGetUser 関数をサポートしている場合、WNNC_USR_GETUSERを返します。

注釈

NPGetCaps から開始時刻が返されると、MPR はこの値を使用して、すべてのネットワーク プロバイダーを再び開始するタイミングを決定します。 MPR は、呼び出されたプロバイダーによって返される最も長い開始時刻を使用します。

Requirements

こちらも参照ください

NPLogonNotify

NPPasswordChangeNotify