WlanGetSupportedDeviceServices 函式 （wlanapi.h）

擷取給定無線LAN介面上支援的裝置服務清單。

語法

DWORD WlanGetSupportedDeviceServices(
  [in]  HANDLE                         hClientHandle,
  [in]  const GUID                     *pInterfaceGuid,
  [out] PWLAN_DEVICE_SERVICE_GUID_LIST *ppDevSvcGuidList
);

參數

[in] hClientHandle

類型： 手柄

用戶端的會話控制碼，由先前呼叫 WlanOpenHandle 函式所取得。

[in] pInterfaceGuid

類型： CONST GUID*

要查詢之無線 LAN 介面 GUID 的指標。 您可以使用 WlanEnumInterfaces 函式來判斷本機電腦上啟用的每個無線 LAN 介面的 GUID。

[out] ppDevSvcGuidList

類型： PWLAN_DEVICE_SERVICE_GUID_LIST*

儲存體的指標，用於接收WLAN_DEVICE_SERVICE_GUID_LIST結構中傳回的裝置服務 GUID清單。 如果呼叫成功，則傳回 WLAN_DEVICE_SERVICE_GUID_LIST 的緩衝區會由 WlanGetSupportedDeviceServices 函式配置。

返回值

類型： HRESULT

如果函式成功，則傳回值為 ERROR_SUCCESS。 如果函式失敗並 ERROR_ACCESS_DENIED，則呼叫端沒有足夠的許可權來執行此作業。 呼叫端必須具有系統管理員許可權，或必須是 UMDF 驅動程式。

備註

如果呼叫成功，則 WlanGetSupportedDeviceServices 函式會配置裝置服務 GUID 清單的記憶體，該清單會在 ppDevSvcGuidList 參數所指向的緩衝區中傳回。 當您不再需要 ppDevSvcGuidList 所指向的緩衝區時，您應該呼叫 WlanFreeMemory 函式來釋放用於它的記憶體。

需求