PF_NPGetCaps
コールバックシグネチャ
DWORD PF_NPGetCaps(
DWORD ndex
);パラメーター
| フィールド | 型 |
|---|---|
| ndex | DWORD |
公式ドキュメント
ネットワーク上でどのサービスがサポートされているかに関する情報を返します。
戻り値
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 はそのネットワークプロバイダーの開始を再試行しません。 |
| 時間 | プロバイダーが開始するまでの時間をミリ秒単位で示します。 |
| 0xFFFFFFFF | プロバイダーが、いつ開始するかを把握していないことを示します。ネットワークプロバイダーがこの値を返した場合、MPR は既定値である 60 秒を使用します。 |
| 0x1 | プロバイダーが既に開始していることを示します。 |
####WNNC_USER ネットワークプロバイダーが NPGetUser 関数をサポートしている場合、WNNC_USR_GETUSER を返します。
解説(Remarks)
NPGetCaps が開始時間を返した場合、MPR はこの値を使用して、すべてのネットワークプロバイダーの開始を再度試みる時期を判断します。MPR は、呼び出したプロバイダーが返した開始時間のうち、最も長いものを使用します。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)