NPGetCaps 関数 (npapi.h)
ネットワークでサポートされているサービスに関する情報を返します。
構文
DWORD NPGetCaps(
DWORD ndex
);
パラメーター
ndex
戻り値
NPGetCaps 関数は、nIndex パラメーターの値に応じて、定数またはビットマスクを返します。 nIndex 値の一部を指定すると、定数が返されます。 ただし、ほとんどの場合、 nIndex パラメーターはクエリを実行するサービスのセットを指定し、返される値は、このセット内のどのサービスがサポートされているかを示すビットマスクです。 このような場合、0 の戻り値は、セット内のどのサービスもサポートされていないことを示します。
次の一覧は 、nIndex に含まれる可能性がある値を示しています。その後に、その値に対して返される内容の説明が続きます。
####WNNC_ADMIN ネットワーク プロバイダーがサポートする管理関数を示すマスクを返します。 これには、次の 1 つ以上を指定できます。
フラグ | サポートされている関数 |
---|---|
WNNC_ADM_DIRECTORYNOTIFY | NPDirectoryNotify |
WNNC_ADM_GETDIRECTORYTYPE | NPGetDirectoryType |
####WNNC_CONNECTION ネットワーク プロバイダーがサポートする接続関数を示すマスクを返します。 これには、次の 1 つ以上を指定できます。
フラグ | サポートされている関数 |
---|---|
WNNC_CON_ADDCONECTION (0x00000001) | NPAddConnection |
WNNC_CON_CANCELCONNECTION (0x00000002) | NPCancelConnection |
WNNC_CON_GETCONNECTIONS (0x00000004) | NPGetConnection |
WNNC_CON_ADDCONECTION3 (0x00000008) | NPAddConnection3 |
WNNC_CON_GETPERFORMANCE (0x00000040) | NPGetConnectionPerformance |
WNNC_CON_DEFER (0x00000080) | 遅延接続は NPAddConnection3 でサポートされています。 |
####WNNC_DIALOG ネットワーク プロバイダーがサポートするダイアログ ボックスの関数を示すマスクを返します。 これには、次の 1 つ以上を指定できます。
フラグ | サポートされている関数 |
---|---|
WNNC_DLG_DEVICEMODE | NPDeviceMode |
WNNC_DLG_FORMATNETNAME | NPFormatNetworkName |
WNNC_DLG_GETRESOURCEINFORMATION | NPGetResourceInformation |
WNNC_DLG_GETRESOURCEPARENT | NPGetResourceParent |
WNNC_DLG_PERMISSIONEDITOR | このフラグは使用されません。 |
WNNC_DLG_PROPERTYDIALOG | NPPropertyDialog と NPGetPropertyText |
WNNC_DLG_SEARCHDIALOG | NPSearchDialog |
####WNNC_ENUMERATION
サポートされている列挙のスコープ (ある場合) を示すマスクを返します。 列挙スコープの詳細については、参照トピック NPOpenEnum の「パラメーター」セクションを参照してください。 これには、次の 1 つ以上を指定できます。
フラグ | サポートされている列挙型 |
---|---|
WNNC_ENUM_GLOBAL (0x00000001) | NPOpenEnum は実装され、ネットワーク上のすべてのリソースのスコープをサポートします。 言い換えると、NPOpenEnum はRESOURCE_GLOBALNETをサポートします。 |
WNNC_ENUM_LOCAL (0x00000002) | NPOpenEnum は実装され、現在接続されているすべてのリソースのスコープをサポートします。 言い換えると、NPOpenEnum はRESOURCE_CONNECTEDをサポートします。 |
WNNC_ENUM_CONTEXT (0x00000004) | NPOpenEnum は実装され、ユーザーの現在および既定のネットワーク コンテキストに関連付けられているすべてのリソースのスコープをサポートします。 言い換えると、NPOpenEnum はRESOURCE_CONTEXTをサポートします。 |
メモ 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 は、すべてのネットワーク プロバイダーによって指定された最長のタイムアウト期間を待機します。
フラグ | 開始時刻 |
---|---|
0x0 | プロバイダーが無効になっている場合など、プロバイダーが起動しないことを示します。 MPR は、ネットワーク プロバイダーの起動を再試行しません。 |
Time | プロバイダーが起動するまでの時間をミリ秒単位で示します。 |
0xFFFFFFFF | プロバイダーがいつ開始されるかを認識しないことを示します。 ネットワーク プロバイダーがこの値を返す場合、MPR は既定値である 60 秒を使用します。 |
0x1 | プロバイダーが既に開始されていることを示します。 |
####WNNC_USER ネットワーク プロバイダーが NPGetUser 関数をサポートしている場合は、WNNC_USR_GETUSERを返します。
注釈
NPGetCaps によって開始時刻が返されると、MPR はこの値を使用して、すべてのネットワーク プロバイダーを再び開始するタイミングを決定します。 MPR では、呼び出したプロバイダーによって返される最も長い開始時刻が使用されます。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows XP (デスクトップ アプリのみ) |
サポートされている最小のサーバー | Windows Server 2003 (デスクトップ アプリのみ) |
対象プラットフォーム | Windows |
ヘッダー | npapi.h |