WZCEapolGetInterfaceParams-Funktion

[WZCEapolGetInterfaceParams wird ab Windows Vista und Windows Server 2008 nicht mehr unterstützt. Verwenden Sie stattdessen die Native Wifi-API, die ähnliche Funktionen bietet. Weitere Informationen finden Sie unter Informationen zur Native Wifi-API.]

Die WZCEapolGetInterfaceParams-Funktion ruft EAPOL-Konfigurationsparameter für die angegebene WLAN-Schnittstelle ab.

Syntax

DWORD WZCEapolGetInterfaceParams(
  _In_    LPWSTR            pSrvAddr,
  _In_    PWCHAR            pwszGuid,
  _In_    DWORD             dwSizeOfSSID,
  _In_    BYTE              *pbSSID,
  _Inout_ EAPOL_INTF_PARAMS *pIntfParams
);

Parameter

pSrvAddr [ In]

Ein Zeiger auf eine Zeichenfolge, die den Namen des Computers enthält, auf dem diese Funktion ausgeführt werden soll. Wenn dieser Parameter NULL ist, wird der Wireless Zero Configuration-Dienst auf dem lokalen Computer aufgerufen.

Wenn der angegebene pSrvAddr-Parameter ein Remotecomputer ist, muss der Remotecomputer Remote-RPC-Aufrufe unterstützen.

pwszGuid [ In]

Die GUID der Schnittstelle, für die Daten abgerufen werden sollen.

dwSizeOfSSID [ In]

Die Größe des Netzwerkbezeichners, für den Daten abgerufen werden sollen.

pbSSID [ In]

Ein Zeiger auf den Netzwerkbezeichner, für den Daten abgerufen werden sollen.

pIntfParams [ in, out]

Ein Zeiger auf eine EAPOL _ INTF _ PARAMS-Struktur, die Schnittstellenparameter enthält.

Rückgabewert

Gibt ERROR _ SUCCESS zurück, wenn der Vorgang erfolgreich abgeschlossen wurde. Andernfalls wird einer der Windows Systemfehlercodes zurückgegeben.

Bemerkungen

Wenn WZCEapolGetInterfaceParams ERROR _ SUCCESS zurückgibt, sollte der Aufrufer LocalFree aufrufen, um die internen Puffer freizugeben, die für die zurückgegebenen Daten zugeordnet sind, sobald diese Informationen nicht mehr benötigt werden.

Hinweis

Die Headerdatei "Wzcsapi.h" und die Importbibliotheksdatei "Wzcsapi.lib" sind im Windows SDK nicht verfügbar.

Requirements (Anforderungen)

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows Nur XP mit [ SP2-Desktop-Apps]
Unterstützte Mindestversion (Server)
Windows Nur Server [ 2003-Desktop-Apps]
Ende des Supports (Client)
Windows XP mit SP3
Ende des Supports (Server)
Windows Server 2003
Header
Wzcsapi.h
Bibliothek
Wzcsapi.lib
DLL
Wzcsapi.dll

Weitere Informationen

WZCEnumInterfaces

WZCQueryInterface

WZCRefreshInterface