WZCQueryInterface 関数

[アーティクル]
06/13/2023

[WZCQueryInterface は、Windows Vista および Windows Server 2008 以降ではサポートされていません。代わりに WlanQueryInterface 関数を使用してください。詳細については、「ネイティブ Wifi API について」を参照してください。 ]

WZCQueryInterface 関数は、ワイヤレスゼロ構成サービスによって管理されるワイヤレス LAN インターフェイスの詳細情報を提供します。

特定のインターフェイスの詳細情報を提供します。

構文

DWORD WZCQueryInterface(
  _In_    LPWSTR      pSrvAddr,
  _In_    DWORD       dwInFlags,
  _Inout_ PINTF_ENTRY pIntf,
  _Out_   LPDWORD     pdwOutFlags
);

パラメーター

pSrvAddr [in]

この関数を実行するコンピューターの名前を含む文字列へのポインター。このパラメーターが NULL の場合、ワイヤレスゼロ構成サービスはローカルコンピューターで照会されます。

指定された pSrvAddr パラメーターがリモートコンピューターの場合、リモートコンピューターはリモート RPC 呼び出しをサポートする必要があります。

dwInFlags [in]

クエリを実行するフィールド。これは、次のフラグの任意の組み合わせを含むことができるビットマスクです。

値	説明
INTF_DYNFLAGS 0x00000010	pIntf パラメーターが指すINTF_ENTRY構造体の dwDynFlags メンバーの値を返します。
INTF_DESCR 0x00010000	pIntf パラメーターが指すINTF_ENTRY構造体の wszDescr メンバーの値を返します。
INTF_NDISMEDIA 0x00020000	pIntf パラメーターが指すINTF_ENTRY構造体の ulMediaState、ulMediaType、および ulPhysicalMediaType メンバーの値を返します。
INTF_PREFLIST 0x00040000	pIntf パラメーターが指すINTF_ENTRY構造体の rdStSSIDList メンバー内のネットワークの優先リストを返します。
INTF_CAPABILITIES 0x00080000	pIntf パラメーターが指すINTF_ENTRY構造体の dwCapabilities メンバーと rdNicCapabilities メンバーの値を返します。
INTF_INFRAMODE 0x00200000	pIntf パラメーターが指すINTF_ENTRY構造体の nInfraMode メンバーの値を返します。 nInfraMode メンバーは、一部のインターフェイスコンテキスト状態でのみ有効です。
INTF_AUTHMODE 0x00400000	pIntf パラメーターが指すINTF_ENTRY構造体の nAuthMode メンバーの値を返します。 nAuthMode メンバーは、一部のインターフェイスコンテキスト状態でのみ有効です。
INTF_WEPSTATUS 0x00800000	pIntf パラメーターが指すINTF_ENTRY構造体の nWepStatus メンバーの値を返します。 nWepStatus メンバーは、一部のインターフェイスコンテキスト状態でのみ有効です。
INTF_SSID 0x01000000	pIntf パラメーターが指すINTF_ENTRY構造体の rdSSID メンバーの値を返します。 rdSSID メンバーは、一部のインターフェイスコンテキスト状態でのみ有効です。
INTF_BSSID 0x02000000	pIntf パラメーターが指すINTF_ENTRY構造体の rdBSSID メンバーの値を返します。 rdBSSID メンバーは、一部のインターフェイスコンテキスト状態でのみ有効です。
INTF_BSSIDLIST 0x04000000	pIntf パラメーターが指すINTF_ENTRY構造体の rdBSSIDList メンバー内のネットワークの表示リストを返します。 rdBSSIDList メンバーは、一部のインターフェイスコンテキスト状態でのみ有効です。

pIntf [in, out]

入力時に、クエリを実行するインターフェイスのキーへのポインター。出力時に、要求されたインターフェイスデータへのポインター。このパラメーターは、 INTF_ENTRY 構造体へのポインターです。

pdwOutFlags [out]

一連のフィールドが正常に取得されました。

戻り値

関数が成功した場合、戻り値は ERROR_SUCCESS です。

関数が失敗した場合、戻り値は次のいずれかのリターンコードになります。

リターンコード	説明
ERROR_ARENA_TRASHED	ストレージ制御ブロックが破棄されました。このエラーは、ワイヤレスゼロ構成サービスが内部オブジェクトを初期化していない場合に返されます。
ERROR_FILE_NOT_FOUND	指定されたファイルが見つかりません。このエラーは、pIntf パラメーターが指すINTF_ENTRY構造体の wszGuid メンバーの GUID が、ローカルコンピューター上のワイヤレス LAN インターフェイスのいずれにも一致しなかった場合に返されます。
ERROR_INVALID_PARAMETER	パラメーターが正しくありません。このエラーは、 pIntf パラメーターが NULL の場合に返されます。このエラーは、pIntf パラメーターが指すINTF_ENTRY構造体の wszGuid メンバーが NULL の場合に返されます。
ERROR_NOT_ENOUGH_MEMORY	この要求を処理し、クエリ結果のメモリを割り当てるのに十分なメモリがありません。
RPC_STATUS	さまざまなエラーコード。

解説

pIntf パラメーターによって指されるINTF_ENTRY構造体の wszGuid メンバーには、ワイヤレス LAN インターフェイスのインターフェイス GUID が含まれている必要があります。ワイヤレス LAN インターフェイスの一覧は、 WZCEnumInterfaces 関数を呼び出すことによって取得できます。

pIntf が指すINTF_ENTRY構造体の次のメンバーは、WZCQueryInterface 関数の呼び出しの前に 0 に設定する必要があります。 rdSSID、rdBSSID、rdBSSIDList、rdStSSIDList、rdCtrlData。

ワイヤレスゼロ構成サービスは、メディアに接続され、切断されたイベントを受信した場合でも、メディアの状態を自動的に更新しません。 NDIS メディア状態が要求される場合は 、WZCQueryInterface 関数を呼び出す前に WZCRefreshInterface 関数を呼び出してメディア状態を強制的に更新する必要があります (INTF_NDISMEDIA ビットは dwInFlags パラメーターに設定されます)。

dwInFlags パラメーターにINTF_BSSIDLISTが含まれている場合、ネットワークの可視リストが空の場合、WZCQueryInterface 関数は dwOutFlags をINTF_BSSIDLISTに設定しません。 dwInFlags パラメーターにINTF_SSIDが含まれている場合、使用可能な SSID がない場合、WZCQueryInterface 関数は dwOutFlags をINTF_SSIDに設定しません。

WZCQueryInterface 関数がERROR_SUCCESSを返す場合、呼び出し元は pIntf パラメーターを使用して LocalFree 関数を呼び出して、この情報が不要になったら返されるデータに割り当てられた内部バッファーを解放する必要があります。これにより、pIntf パラメーターによって指されるINTF_ENTRY構造体の rdSSID、rdBSSID、rdBSSIDList、rdStSSIDList、および rdCtrlData メンバーによって使用されるバッファーが解放されます。

Note

Wzcsapi.h ヘッダーファイルと Wzcsapi.lib インポートライブラリファイルは、Windows SDK では使用できません。

要件

要件	値
サポートされている最小のクライアント	WINDOWS XP と SP2 [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2003 [デスクトップアプリのみ]
クライアントサポートの終了	SP3 を使用した Windows XP
サーバーサポートの終了	Windows Server 2003
ヘッダー	Wzcsapi.h
ライブラリ	Wzcsapi.lib
[DLL]	Wzcsapi.dll

次の方法で共有

WZCQueryInterface 関数

構文

パラメーター

戻り値

解説

要件

関連項目

フィードバック

その他のリソース