WlanIhvControl 関数 (wlanapi.h)
WlanIhvControl 関数は、WLAN ドライバーまたはサービスの独立したハードウェア ベンダー (IHV) 制御のメカニズムを提供します。
構文
DWORD WlanIhvControl(
[in] HANDLE hClientHandle,
[in] const GUID *pInterfaceGuid,
[in] WLAN_IHV_CONTROL_TYPE Type,
[in] DWORD dwInBufferSize,
[in] PVOID pInBuffer,
[in] DWORD dwOutBufferSize,
[in, out, optional] PVOID pOutBuffer,
[out] PDWORD pdwBytesReturned
);
パラメーター
[in] hClientHandle
WlanOpenHandle 関数の以前の呼び出しによって取得されたクライアントのセッション ハンドル。
[in] pInterfaceGuid
インターフェイスの GUID。
[in] Type
IHV 制御関数によってバイパスされるソフトウェアの種類を指定するWLAN_IHV_CONTROL_TYPE構造体。
[in] dwInBufferSize
入力バッファーのサイズ (バイト単位)。
[in] pInBuffer
ドライバーまたはサービス インターフェイス入力用のジェネリック バッファー。
[in] dwOutBufferSize
出力バッファーのサイズ (バイト単位)。
[in, out, optional] pOutBuffer
ドライバーまたはサービス インターフェイス出力用のジェネリック バッファー。
[out] pdwBytesReturned
返されるバイト数。
戻り値
関数が成功した場合、戻り値は ERROR_SUCCESS です。
関数が失敗した場合、戻り値は次のいずれかのリターン コードになります。
リターン コード | 説明 |
---|---|
|
呼び出し元には、この操作を実行するための十分なアクセス許可がありません。 呼び出されると、 WlanIhvControl は 、wlan_secure_ihv_control オブジェクトと共に格納されている随意アクセス制御リスト (DACL) を取得します。 DACL に、呼び出し元スレッドのアクセス トークンに対するアクセス許可WLAN_WRITE_ACCESS付与するアクセス制御エントリ (ACE) が含まれていない場合、 WlanIhvControl は ERROR_ACCESS_DENIEDを返します。 |
|
hClientHandle が NULL または無効、 pInterfaceGuid が NULL、 または pdwBytesReturned が NULL です。 |
|
ハンドル テーブルにハンドル hClientHandle が見つかりませんでした。 |
|
この関数は、サポートされていないプラットフォームから呼び出されました。 この値は、SP3 の Windows XP または SP2 クライアントを使用した Windows XP 用ワイヤレス LAN API からこの関数が呼び出された場合に返されます。 |
|
さまざまなエラー コード。 |
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | wlanapi.h (Wlanapi.h を含む) |
Library | Wlanapi.lib |
[DLL] | Wlanapi.dll |