Freigeben über

WZCQueryInterface-Funktion

  • Artikel

[WZCQueryInterface wird ab Windows Vista und Windows Server 2008 nicht mehr unterstützt. Verwenden Sie stattdessen die WlanQueryInterface-Funktion . Weitere Informationen finden Sie unter Informationen zur nativen Wifi-API. ]

Die WZCQueryInterface-Funktion bietet detaillierte Informationen zu einer WLAN-Schnittstelle, die vom Wireless Zero Configuration-Dienst verwaltet wird.

Stellt detaillierte Informationen für eine bestimmte Schnittstelle bereit.

Syntax

DWORD WZCQueryInterface(
  _In_    LPWSTR      pSrvAddr,
  _In_    DWORD       dwInFlags,
  _Inout_ PINTF_ENTRY pIntf,
  _Out_   LPDWORD     pdwOutFlags
);

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 abgefragt.

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

dwInFlags [in]

Die abzufragten Felder. Dies ist eine Bitmaske, die eine beliebige Kombination der folgenden Flags enthalten kann.

Wert Bedeutung
INTF_DYNFLAGS
0x00000010
 Gibt den Wert für den dwDynFlags-Member in der INTF_ENTRY-Struktur zurück, auf die der pIntf-Parameter verweist.
INTF_DESCR
0x00010000
 Gibt den Wert für das wszDescr-Element in der INTF_ENTRY-Struktur zurück, auf die der pIntf-Parameter verweist.
INTF_NDISMEDIA
0x00020000
 Gibt die Werte für die Member ulMediaState, ulMediaType und ulPhysicalMediaType in der INTF_ENTRY-Struktur zurück, auf die der pIntf-Parameter verweist.
INTF_PREFLIST
0x00040000
 Gibt die bevorzugte Liste der Netzwerke im rdStSSIDList-Element der INTF_ENTRY-Struktur zurück, auf die der pIntf-Parameter verweist.
INTF_CAPABILITIES
0x00080000
 Gibt die Werte für die elemente dwCapabilities und rdNicCapabilities in der INTF_ENTRY-Struktur zurück, auf die der pIntf-Parameter verweist.
INTF_INFRAMODE
0x00200000
 Gibt den Wert für das nInfraMode-Element in der INTF_ENTRY-Struktur zurück, auf die der pIntf-Parameter verweist.
Der nInfraMode-Member ist nur in einigen Schnittstellenkontextzuständen gültig.
INTF_AUTHMODE
0x00400000
 Gibt den Wert für das nAuthMode-Element in der INTF_ENTRY-Struktur zurück, auf die der pIntf-Parameter verweist.
Der nAuthMode-Member ist nur in einigen Schnittstellenkontextzuständen gültig.
INTF_WEPSTATUS
0x00800000
 Gibt den Wert für den nWepStatus-Member in der INTF_ENTRY-Struktur zurück, auf die der pIntf-Parameter verweist.
Der nWepStatus-Member ist nur in einigen Schnittstellenkontextzuständen gültig.
INTF_SSID
0x01000000
 Gibt den Wert für den rdSSID-Member in der INTF_ENTRY-Struktur zurück, auf die der pIntf-Parameter verweist.
Der rdSSID-Member ist nur in einigen Schnittstellenkontextzuständen gültig.
INTF_BSSID
0x02000000
 Gibt den Wert für das rdBSSID-Element in der INTF_ENTRY-Struktur zurück, auf die der pIntf-Parameter verweist.
Der rdBSSID-Member ist nur in einigen Schnittstellenkontextzuständen gültig.
INTF_BSSIDLIST
0x04000000
 Gibt die sichtbare Liste der Netzwerke im rdBSSIDList-Element der INTF_ENTRY-Struktur zurück, auf die der pIntf-Parameter verweist.
Das rdBSSIDList-Element ist nur in einigen Schnittstellenkontextzuständen gültig.

 

pIntf [in, out]

Bei der Eingabe ein Zeiger auf den Schlüssel der abzufragenden Schnittstelle. Bei der Ausgabe ein Zeiger auf die angeforderten Schnittstellendaten. Dieser Parameter ist ein Zeiger auf eine INTF_ENTRY-Struktur .

pdwOutFlags [out]

Eine Reihe von Feldern wurde erfolgreich abgerufen.

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_ARENA_TRASHED
 Die Speicherkontrollblöcke wurden zerstört. Dieser Fehler wird zurückgegeben, wenn der Wireless Zero Configuration-Dienst keine internen Objekte initialisiert hat.
ERROR_FILE_NOT_FOUND
 Die angegebene Datei wurde nicht gefunden. Dieser Fehler wird zurückgegeben, wenn die GUID im wszGuid-Member der INTF_ENTRY Struktur, auf die der pIntf-Parameter verweist, keiner der WLAN-Schnittstellen auf dem lokalen Computer entspricht.
ERROR_INVALID_PARAMETER
 Ein Parameter ist falsch. Dieser Fehler wird zurückgegeben, wenn der pIntf-ParameterNULL ist. Dieser Fehler wird zurückgegeben, wenn der wszGuid-Member der INTF_ENTRY Struktur, auf die der pIntf-Parameter verweist, NULL ist.
ERROR_NOT_ENOUGH_MEMORY
 Es ist nicht genügend Arbeitsspeicher verfügbar, um diese Anforderung zu verarbeiten und Arbeitsspeicher für die Abfrageergebnisse zuzuweisen.
RPC_STATUS
 Verschiedene Fehlercodes.

 

Bemerkungen

Das wszGuid-Element der INTF_ENTRY Struktur, auf die der pIntf-Parameter verweist, muss eine Schnittstellen-GUID für eine WLAN-Schnittstelle enthalten. Eine Liste der WLAN-Schnittstellen kann durch Aufrufen der WZCEnumInterfaces-Funktion abgerufen werden.

Die folgenden Member der INTF_ENTRY Struktur, auf die pIntf verweist, müssen vor einem Aufruf der WZCQueryInterface-Funktion auf 0 festgelegt werden: rdSSID, rdBSSID,rdBSSIDList, rdStSSIDList und rdCtrlData.

Der Wireless Zero Configuration-Dienst aktualisiert den Medienzustand nicht automatisch, selbst wenn verbundene Medien und getrennte Ereignisse empfangen werden. Eine Anwendung sollte eine Medienzustandsaktualisierung erzwingen, indem sie die WZCRefreshInterface-Funktion aufruft, bevor die WZCQueryInterface-Funktion aufgerufen wird, wenn der NDIS-Medienzustand angefordert werden soll (das INTF_NDISMEDIA Bit wird im dwInFlags-Parameter festgelegt).

Wenn der dwInFlags-ParameterINTF_BSSIDLIST enthält, legt die WZCQueryInterface-Funktion die dwOutFlags nicht mit INTF_BSSIDLIST fest, wenn die sichtbare Liste der Netzwerke leer ist. Wenn der dwInFlags-ParameterINTF_SSID enthält, legt die WZCQueryInterface-FunktiondwOutFlags nicht mit INTF_SSID fest, wenn keine SSID verfügbar ist.

Wenn die WZCQueryInterface-Funktion ERROR_SUCCESS zurückgibt, sollte der Aufrufer die LocalFree-Funktion mit dem pIntf-Parameter aufrufen, um die internen Puffer freizugeben, die den zurückgegebenen Daten zugeordnet sind, sobald diese Informationen nicht mehr benötigt werden. Dadurch werden die Puffer freigegeben, die von den Elementen rdSSID, rdBSSID, rdBSSIDList, rdStSSIDList und rdCtrlData der INTF_ENTRY Struktur verwendet werden, auf die der pIntf-Parameter verweist.

Hinweis

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

 

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client)
 Windows XP mit SP2 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)
 Windows Server 2003 [nur 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

Siehe auch

INTF_ENTRY

WZCEapolGetInterfaceParams

WZCEnumInterfaces

WZCRefreshInterface