Share via

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 です。

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

リターン コード 説明
ERROR_ACCESS_DENIED
 呼び出し元には、この操作を実行するための十分なアクセス許可がありません。 呼び出されると、 WlanIhvControl は 、wlan_secure_ihv_control オブジェクトと共に格納されている随意アクセス制御リスト (DACL) を取得します。 DACL に、呼び出し元スレッドのアクセス トークンに対するアクセス許可WLAN_WRITE_ACCESS付与するアクセス制御エントリ (ACE) が含まれていない場合、 WlanIhvControl は ERROR_ACCESS_DENIEDを返します。
ERROR_INVALID_PARAMETER
 hClientHandle が NULL または無効、 pInterfaceGuid が NULL、 または pdwBytesReturned が NULL です。
ERROR_INVALID_HANDLE
 ハンドル テーブルにハンドル hClientHandle が見つかりませんでした。
ERROR_NOT_SUPPORTED
 この関数は、サポートされていないプラットフォームから呼び出されました。 この値は、SP3 の Windows XP または SP2 クライアントを使用した Windows XP 用ワイヤレス LAN API からこの関数が呼び出された場合に返されます。
RPC_STATUS
 さまざまなエラー コード。

要件

要件 値
サポートされている最小のクライアント Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー wlanapi.h (Wlanapi.h を含む)
Library Wlanapi.lib
[DLL] Wlanapi.dll

こちらもご覧ください

WLAN_IHV_CONTROL_TYPE