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 bereitstellt. Weitere Informationen finden Sie unter Informationen zur nativen 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 RPC-Remoteaufrufe 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 wird. Gibt andernfalls einen der Windows-Systemfehlercodes zurück.

Bemerkungen

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

Anforderungen

Weitere Informationen

WZCEnumInterfaces

WZCQueryInterface

WZCRefreshInterface