WlanGetSupportedDeviceServices-Funktion (wlanapi.h)
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 |