WlanGetSupportedDeviceServices 関数 (wlanapi.h)

特定のワイヤレス LAN インターフェイスでサポートされているデバイス サービスの一覧を取得します。

構文

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

パラメーター

[in] hClientHandle

型: HANDLE

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 関数は、ppDevSvcGuidList パラメーターによって指されるバッファーで返されるデバイス サービス GUID リストのメモリを割り当てます。 ppDevSvcGuidList が指すバッファーが不要になったら、WlanFreeMemory 関数を呼び出して、そのバッファーに使用されるメモリを解放する必要があります。

Requirements