WlanGetSupportedDeviceServices-Funktion (wlanapi.h)

Artikel
03/13/2024

Ruft eine Liste der unterstützten Gerätedienste auf einer bestimmten WLAN-Schnittstelle ab.

Syntax

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

Parameter

[in] hClientHandle

Typ: HANDLE

Das Sitzungshandle des Clients, das durch einen vorherigen Aufruf der WlanOpenHandle-Funktion abgerufen wurde.

[in] pInterfaceGuid

Typ: CONST GUID*

Ein Zeiger auf die GUID der abzufragten WLAN-Schnittstelle. Sie können die GUID jeder auf einem lokalen Computer aktivierten WLAN-Schnittstelle mithilfe der Funktion WlanEnumInterfaces ermitteln.

[out] ppDevSvcGuidList

Typ: PWLAN_DEVICE_SERVICE_GUID_LIST*

Ein Zeiger auf den Speicher für einen Zeiger, der die zurückgegebene Liste der Gerätedienst-GUIDsin einer WLAN_DEVICE_SERVICE_GUID_LIST-Struktur empfängt. Wenn der Aufruf erfolgreich ist, wird der Puffer für die zurückgegebene WLAN_DEVICE_SERVICE_GUID_LIST von der WlanGetSupportedDeviceServices-Funktion zugeordnet.

Rückgabewert

Typ: HRESULT

Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS. Wenn die Funktion mit ERROR_ACCESS_DENIED fehlschlägt, verfügt der Aufrufer nicht über ausreichende Berechtigungen, um diesen Vorgang auszuführen. Der Aufrufer muss entweder über Administratorrechte verfügen oder ein UMDF-Treiber sein.

Hinweise

Wenn der Aufruf erfolgreich ist, ordnet die WlanGetSupportedDeviceServices-Funktion Arbeitsspeicher für die GUID-Liste der Gerätedienste zu, die in einem Puffer zurückgegeben wird, auf den der ppDevSvcGuidList-Parameter verweist. Wenn Sie den Puffer, auf den ppDevSvcGuidList verweist, nicht mehr benötigen, sollten Sie den dafür verwendeten Arbeitsspeicher freigeben, indem Sie die WlanFreeMemory-Funktion aufrufen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 10 Build 20348
Unterstützte Mindestversion (Server)	Windows 10 Build 20348
Kopfzeile	wlanapi.h

Freigeben über