WZCRefreshInterface-Funktion
[WZCRefreshInterface wird ab Windows Vista und Windows Server 2008 nicht unterstützt. Verwenden Sie stattdessen die NATIVE WIFI-API,die ähnliche Funktionen bietet. Weitere Informationen finden Sie unter Informationen zur nativen WLAN-API.]
Die WZCRefreshInterface-Funktion aktualisiert Schnittstelleninformationen für eine bestimmte WLAN-Schnittstelle.
Syntax
DWORD WZCRefreshInterface(
_In_ LPWSTR pSrvAddr,
_In_ DWORD dwInFlags,
_In_ 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 aufgerufen.
Wenn der angegebene pSrvAddr-Parameter ein Remotecomputer ist, muss der Remotecomputer REMOTE-RPC-Aufrufe unterstützen.
-
dwInFlags [ In]
-
Eine Gruppe von Feldern, die aktualisiert werden sollen, sowie bestimmte Aktualisierungsaktionen, die durchgeführt werden sollen. Dies ist eine Bitmaske, die eine beliebige Kombination der folgenden Flags enthalten kann.
Wert Bedeutung - INTF _ DESCR
- 0x00010000
Aktualisieren Sie die Schnittstellenbeschreibung für eine WLAN-Schnittstelle.
Die aktualisierte Schnittstellenbeschreibung kann abgerufen werden, indem die WZCQueryInterface-Funktion mit dem im dwInFlags-Parameter festgelegten INTF _ DESCR-Bit aufgerufen wird. Die Schnittstellenbeschreibung wird im wszDescr-Member der INTF _ ENTRY-Struktur zurückgegeben, auf die der pIntf-Parameter verweist, der von der WZCQueryInterface-Funktion zurückgegeben wird.- INTF _ NDISMEDIA-0x00020000
Aktualisieren Sie die NDIS-Medieninformationen für eine DRAHTLOSE LAN-Schnittstelle.
Die aktualisierten NDIS-Medieninformationen können durch Aufrufen der WZCQueryInterface-Funktion mit dem im dwInFlags-Parameter festgelegten INTF _ NDISMEDIA-Bit abgerufen werden. Die NDIS-Medieninformationen werden in den Membern ulMediaState, ulMediaType und ulPhysicalMediaType der INTF _ ENTRY-Struktur zurückgegeben, auf die der pIntf-Parameter verweist, der von der WZCQueryInterface-Funktion zurückgegeben wird.- INTF _ ALLE _ OIDS
- 0xFFF00000
Aktualisieren Sie alle NDIS-OIDs für eine DRAHTLOSE LAN-Schnittstelle. Mit dieser Option werden die meisten Daten für eine WLAN-Schnittstelle aktualisiert.
Die aktualisierten Informationen können durch Aufrufen der WZCQueryInterface-Funktion abgerufen werden. -
pIntf [ In]
-
Ein Zeiger auf eine INTF _ ENTRY-Struktur, die den Schlüssel der zu aktualisierenden Schnittstelle enthält.
-
pdwOutFlags [ out]
-
Ein Satz von Feldern, die erfolgreich aktualisiert 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 |
|---|---|
|
Die Speicherkontrollblöcke wurden zerstört. Dieser Fehler wird zurückgegeben, wenn der Wireless Zero Configuration-Dienst keine internen Objekte initialisiert hat. |
|
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. |
|
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. |
|
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.
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 |
|
| Bibliothek |
|
| DLL |
|