WZCRefreshInterface 関数
[WZCRefreshInterface は、Windows Vista および Windows Server 2008 の時点ではサポートされていません。 代わりに、同様の機能を提供する Native Wifi API を使用してください。 詳細については、「 ネイティブ Wifi API について」を参照してください。
WZCRefreshInterface 関数は、特定のワイヤレス LAN インターフェイスのインターフェイス情報を更新します。
構文
DWORD WZCRefreshInterface(
_In_ LPWSTR pSrvAddr,
_In_ DWORD dwInFlags,
_In_ PINTF_ENTRY pIntf,
_Out_ LPDWORD pdwOutFlags
);
パラメーター
-
pSrvAddr [in]
-
この関数を実行するコンピューターの名前を含む文字列へのポインター。 このパラメーターが NULL の場合は、ローカル コンピューターでワイヤレス ゼロ構成サービスが呼び出されます。
指定された pSrvAddr パラメーターがリモート コンピューターの場合、リモート コンピューターはリモート RPC 呼び出しをサポートする必要があります。
-
dwInFlags [in]
-
更新する一連のフィールドと、実行する特定の更新アクション。 これは、次のフラグの任意の組み合わせを含むことができるビットマスクです。
値 説明 - INTF_DESCR
- 0x00010000
ワイヤレス LAN インターフェイスのインターフェイスの説明を更新します。
更新されたインターフェイスの説明は、dwInFlags パラメーターに設定されたINTF_DESCR ビットを使用して WZCQueryInterface 関数を呼び出すことによって取得できます。 インターフェイスの説明は、WZCQueryInterface 関数によって返される pIntf パラメーターによって指されるINTF_ENTRY構造体の wszDescr メンバーで返されます。- INTF_NDISMEDIA
- 0x00020000
ワイヤレス LAN インターフェイスの NDIS メディア情報を更新します。
更新された NDIS メディア情報は、dwInFlags パラメーターに設定されたINTF_NDISMEDIA ビットを使用して WZCQueryInterface 関数を呼び出すことによって取得できます。 NDIS メディア情報は、WZCQueryInterface 関数によって返される pIntf パラメーターによって指されるINTF_ENTRY構造体の ulMediaState、ulMediaType、および ulPhysicalMediaType メンバーで返されます。- INTF_ALL_OIDS
- 0xFFF00000
ワイヤレス LAN インターフェイスのすべての NDIS OID を更新します。 このオプションは、ワイヤレス LAN インターフェイスのほとんどのデータを更新します。
更新された情報は、 WZCQueryInterface 関数を呼び出すことによって取得できます。 -
pIntf [in]
-
更新するインターフェイスのキーを含む INTF_ENTRY 構造体へのポインター。
-
pdwOutFlags [out]
-
正常に更新されたフィールドのセット。
戻り値
関数が成功した場合、戻り値は ERROR_SUCCESS です。
関数が失敗した場合、戻り値は次のいずれかの戻りコードになる可能性があります。
| リターン コード | 説明 |
|---|---|
|
ストレージ制御ブロックが破棄されました。 ワイヤレス ゼロ構成サービスで内部オブジェクトが初期化されていない場合、このエラーが返されます。 |
|
指定されたファイルが見つかりません。 このエラーは、pIntf パラメーターが指すINTF_ENTRY構造体の wszGuid メンバーの GUID が、ローカル コンピューター上のワイヤレス LAN インターフェイスのいずれにも一致しなかった場合に返されます。 |
|
パラメーターが正しくありません。
pIntf パラメーターが NULL の場合、このエラーが返されます。
pIntf パラメーターが指すINTF_ENTRY構造体の wszGuid メンバーが NULL の場合、このエラーが返されます。 |
|
さまざまなエラー コード。 |
解説
pIntf パラメーターが指すINTF_ENTRY構造体の wszGuid メンバーには、ワイヤレス LAN インターフェイスのインターフェイス GUID が含まれている必要があります。 ワイヤレス LAN インターフェイスの一覧は、 WZCEnumInterfaces 関数を呼び出すことによって取得できます。
Note
Wzcsapi.h ヘッダー ファイルと Wzcsapi.lib インポート ライブラリ ファイルは、Windows SDK では使用できません。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
WINDOWS XP と SP2 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
Windows Server 2003 [デスクトップ アプリのみ] |
| クライアント サポートの終了 |
SP3 を使用した Windows XP |
| サーバー サポートの終了 |
Windows Server 2003 |
| ヘッダー |
|
| ライブラリ |
|
| [DLL] |
|
関連項目