WZCQueryInterface-Funktion

[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 WLAN-API. ]

Die WZCQueryInterface-Funktion enthält ausführliche Informationen zu einer wlan-Schnittstelle, die vom Wireless Zero Configuration-Dienst verwaltet wird.

Stellt ausführliche 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 REMOTE-RPC-Aufrufe unterstützen.

dwInFlags [ In]

Die zu abfragenden 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 zeigt.
INTF _ DESCR
0x00010000
Gibt den Wert für den wszDescr-Member in der INTF _ ENTRY-Struktur zurück, auf die der pIntf-Parameter zeigt.
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 zeigt.
INTF _ PREFLIST-0x00040000
Gibt die bevorzugte Liste der Netzwerke im rdStSSIDList-Member der INTF _ ENTRY-Struktur zurück, auf die der pIntf-Parameter zeigt.
INTF _ CAPABILITIES
0x00080000
Gibt die Werte für die dwCapabilities- und rdNicCapabilities-Member in der INTF _ ENTRY-Struktur zurück, auf die der pIntf-Parameter zeigt.
INTF _ INFRAMODE-0x00200000
Gibt den Wert für den nInfraMode-Member in der INTF _ ENTRY-Struktur zurück, auf die der pIntf-Parameter zeigt.
Der nInfraMode-Member ist nur in einigen Schnittstellenkontextzuständen gültig.
INTF _ AUTHMODE-0x00400000
Gibt den Wert für den nAuthMode-Member in der INTF _ ENTRY-Struktur zurück, auf die der pIntf-Parameter zeigt.
Der nAuthMode-Member ist nur in einigen Schnittstellenkontextzuständen gültig.
INTF _ WEPSTATUS-0x00800000
Gibt den Wert für das nWepStatus-Member in der INTF _ ENTRY-Struktur zurück, auf die der pIntf-Parameter zeigt.
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 zeigt.
Der rdSSID-Member ist nur in einigen Schnittstellenkontextzuständen gültig.
INTF _ BSSID-0x02000000
Gibt den Wert für das rdBSSID-Member in der INTF _ ENTRY-Struktur zurück, auf das der pIntf-Parameter zeigt.
Der rdBSSID-Member ist nur in einigen Schnittstellenkontextzuständen gültig.
INTF _ BSSIDLIST-0x04000000
Gibt die sichtbare Liste der Netzwerke im rdBSSIDList-Member der INTF _ ENTRY-Struktur zurück, auf die der pIntf-Parameter zeigt.
Der rdBSSIDList-Member ist nur in einigen Schnittstellenkontextzuständen gültig.

pIntf [ in, out]

Bei der Eingabe ein Zeiger auf den Schlüssel der zu abfragenden Schnittstelle. Bei der Ausgabe ein Zeiger auf die angeforderten Schnittstellendaten. Dieser Parameter ist ein Zeiger auf eine INTF _ ENTRY-Struktur.

pdwOutFlags [ out]

Ein Satz von Feldern, die erfolgreich abgerufen wurden.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ERROR _ SUCCESS.

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

Rückgabecode Beschreibung
FEHLER _ BEIM _ PAPIERKORB
Die Speicherkontrollblöcke wurden zerstört. Dieser Fehler wird zurückgegeben, wenn der Wireless Zero Configuration-Dienst keine internen Objekte initialisiert hat.
FEHLERDATEI _ _ NICHT _ GEFUNDEN
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, nicht mit einer der WLAN-Schnittstellen auf dem lokalen Computer übereinstimmen.
FEHLER _ UNGÜLTIGER _ PARAMETER
Ein Parameter ist falsch. Dieser Fehler wird zurückgegeben, wenn der pIntf-Parameter NULL ist. Dieser Fehler wird zurückgegeben, wenn der wszGuid-Member der INTF _ ENTRY-Struktur, auf die der pIntf-Parameter verweist, NULL ist.
FEHLER: _ NICHT _ GENÜGEND _ ARBEITSSPEICHER
Es ist nicht genügend Arbeitsspeicher verfügbar, um diese Anforderung zu verarbeiten und Arbeitsspeicher für die Abfrageergebnisse zu reservieren.
_RPC-STATUS
Verschiedene Fehlercodes.

Bemerkungen

Der wszGuid-Member der INTF _ ENTRY-Struktur, auf die der pIntf-Parameter zeigt, muss eine Schnittstellen-GUID für eine DRAHTLOSE LAN-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 zeigt, müssen vor einem Aufruf der WZCQueryInterface-Funktion auf 0 festgelegt werden: rdSSID, rdBSSID, rdBSSIDList, rdStSSIDList und rdCtrlData.

Der Drahtlose Zero Configuration-Dienst aktualisiert den Medienzustand selbst dann nicht automatisch, wenn ereignisse empfangen werden, die mit medien verbundenen und getrennten Medien verbunden sind. Eine Anwendung sollte eine Aktualisierung des Medienzustands erzwingen, indem sie die WZCRefreshInterface-Funktion aufruft, bevor sie die WZCQueryInterface-Funktion aufruft, wenn der NDIS-Medienzustand angefordert werden soll (das INTF NDISMEDIA-Bit wird im _ dwInFlags-Parameter festgelegt).

Wenn der dwInFlags-Parameter INTF _ BSSIDLIST enthält, wird von der WZCQueryInterface-Funktion nicht dwOutFlags mit INTF _ BSSIDLIST festgelegt, wenn die sichtbare Liste der Netzwerke leer ist. Wenn der dwInFlags-Parameter INTF _ SSID enthält, wird von der WZCQueryInterface-Funktion nicht dwOutFlags mit INTF _ SSID festgelegt, 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 frei zu geben, die für die zurückgegebenen Daten zugeordnet sind, sobald diese Informationen nicht mehr benötigt werden. Dadurch werden die Puffer, die von den RdSSID-, rdBSSID-, rdBSSIDList-, rdStSSIDList- und rdCtrlData-Membern der INTF _ ENTRY-Struktur verwendet werden, auf die der pIntf-Parameter zeigt, frei.

Hinweis

Die Wzcsapi.h-Headerdatei 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

_INTF-EINTRAG

WZCEapolGetInterfaceParams

WZCEnumInterfaces

WZCRefreshInterface