WlanGetSupportedDeviceServices-Funktion (wlanapi.h)

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

Syntax

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

Die Parameter

[in] hClientHandle

Typ: HANDLE

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

[in] pInterfaceGuid

Typ: CONST GUID*

Ein Zeiger auf die GUID der drahtlosen LAN-Schnittstelle, die abgefragt werden soll. Mithilfe der WlanEnumInterfaces-Funktion können Sie die GUID jeder drahtlosen LAN-Schnittstelle ermitteln, die auf einem lokalen Computer aktiviert ist.

[out] ppDevSvcGuidList

Typ: PWLAN_DEVICE_SERVICE_GUID_LIST*

Ein Zeiger zum Speichern für einen Zeiger, um die zurückgegebene Liste der Gerätedienst-GUIDs in einer WLAN_DEVICE_SERVICE_GUID_LIST-Struktur zu empfangen. Wenn der Aufruf erfolgreich ist, wird der Puffer für die zurückgegebene WLAN_DEVICE_SERVICE_GUID_LIST von der WlanGetSupportedDeviceServices-Funktion zugewiesen.

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 zum Ausführen dieses Vorgangs. Der Aufrufer muss entweder über Administratorrechte verfügen oder ein UMDF-Treiber sein.

Bemerkungen

Wenn der Aufruf erfolgreich ist, weist die WlanGetSupportedDeviceServices-Funktion Speicher 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 nicht mehr benötigen, auf den ppDevSvcGuidList verweist, sollten Sie den dafür verwendeten Speicher freigeben, indem Sie die WlanFreeMemory-Funktion aufrufen.

Anforderungen