WlanGetInterfaceCapability-Funktion (wlanapi.h)

  • Artikel

Die WlanGetInterfaceCapability-Funktion ruft die Funktionen einer Schnittstelle ab.

Syntax

DWORD WlanGetInterfaceCapability(
  [in]  HANDLE                     hClientHandle,
  [in]  const GUID                 *pInterfaceGuid,
        PVOID                      pReserved,
  [out] PWLAN_INTERFACE_CAPABILITY *ppCapability
);

Parameter

[in] hClientHandle

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

[in] pInterfaceGuid

Die GUID dieser Schnittstelle.

pReserved

Für die zukünftige Verwendung reserviert. Muss auf NULL festgelegt werden.

[out] ppCapability

Eine WLAN_INTERFACE_CAPABILITY-Struktur , die Informationen zu den Funktionen der angegebenen Schnittstelle enthält.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS.

Wenn die Funktion fehlschlägt, kann der Rückgabewert einer der folgenden Rückgabecodes sein.

Rückgabecode Beschreibung
ERROR_INVALID_PARAMETER
 hClientHandle ist NULL oder ungültig, pInterfaceGuid ist NULL, pReserved ist nicht NULL, oder ppCapability ist NULL.
ERROR_INVALID_HANDLE
 Das Handle hClientHandle wurde in der Handle-Tabelle nicht gefunden.
ERROR_NOT_SUPPORTED
 Diese Funktion wurde von einer nicht unterstützten Plattform aufgerufen. Dieser Wert wird zurückgegeben, wenn diese Funktion von einem Windows XP-Client mit SP3 oder einer Wlan-LAN-API für Windows XP mit SP2-Client aufgerufen wurde.
RPC_STATUS
 Verschiedene Fehlercodes.

Hinweise

Der Aufrufer ist für den Aufruf der WlanFreeMemory-Funktion verantwortlich, um den ppCapability zugeordneten Speicher freizugeben.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile wlanapi.h (einschließlich Wlanapi.h)
Bibliothek Wlanapi.lib
DLL Wlanapi.dll