共用方式為

WlanIhvControl 函式 (wlanapi.h)

  • 發行項

WlanIhvControl 函式提供獨立硬體廠商的機制， (IHV) 控制 WLAN 驅動程式或服務。

語法

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

WLAN_IHV_CONTROL_TYPE 結構，指定 IHV 控制項函式略過的軟體類型。

[in] dwInBufferSize

輸入緩衝區的大小，以位元組為單位。

[in] pInBuffer

驅動程式或服務介面輸入的泛型緩衝區。

[in] dwOutBufferSize

輸出緩衝區的大小，以位元組為單位。

[in, out, optional] pOutBuffer

驅動程式或服務介面輸出的泛型緩衝區。

[out] pdwBytesReturned

傳回的位元組數目。

傳回值

如果函式成功，傳回值會ERROR_SUCCESS。

如果函式失敗，傳回值可能是下列其中一個傳回碼。

傳回碼 Description
ERROR_ACCESS_DENIED
 呼叫端沒有足夠的許可權可執行這項作業。 呼叫時， WlanIhvControl 會擷取使用 wlan_secure_ihv_control 物件儲存的任意訪問控制清單 (DA) CL。 如果 DACL 不包含存取控制專案 (ACE) 授與呼叫線程存取令牌的WLAN_WRITE_ACCESS許可權， 則 WlanIhvControl 會傳回 ERROR_ACCESS_DENIED。
ERROR_INVALID_PARAMETER
 hClientHandle 為 NULL 或無效， pInterfaceGuid 為 NULL，或 pdwBytesReturned 為 NULL。
ERROR_INVALID_HANDLE
 句柄數據表中找不到句柄 hClientHandle 。
ERROR_NOT_SUPPORTED
 從不支援的平臺呼叫此函式。 如果使用SP2用戶端從具有SP3的Windows XP或適用於Windows XP的無線LAN API 呼叫此函式，將會傳回此值。
RPC_STATUS
 各種錯誤碼。

規格需求

需求 值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 wlanapi.h (包含 Wlanapi.h)
程式庫 Wlanapi.lib
Dll Wlanapi.dll

另請參閱

WLAN_IHV_CONTROL_TYPE