WZCRefreshInterface-Funktion

Artikel
06/13/2023

[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 Drahtlose Nullkonfigurationsdienst auf dem lokalen Computer aufgerufen.

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

dwInFlags [in]

Eine Reihe von Feldern, die aktualisiert werden sollen, sowie bestimmte Aktualisierungsaktionen, die ausgeführt werden müssen. 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 Sie die WZCQueryInterface-Funktion aufrufen, wobei das INTF_DESCR Bit im dwInFlags-Parameter festgelegt ist. 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 WLAN-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 vom pIntf-Parameter verwiesen wird, der von der WZCQueryInterface-Funktion zurückgegeben wird.
INTF_ALL_OIDS 0xFFF00000	Aktualisieren Sie alle NDIS-OIDs für eine WLAN-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]

Eine Reihe von Feldern, die erfolgreich aktualisiert wurden.

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 Speichersteuerungsblö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 vom pIntf-Parameter verwiesen wird, keiner der DRAHTLOS-LAN-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 das wszGuid-Element der INTF_ENTRY Struktur, auf die vom pIntf-Parameter verwiesen wird , NULL ist.
RPC_STATUS	Verschiedene Fehlercodes.

Bemerkungen

Das wszGuid-Element der INTF_ENTRY Struktur, auf die vom pIntf-Parameter verwiesen wird, muss eine Schnittstellen-GUID für eine WLAN-Schnittstelle enthalten. Eine Liste von WLAN-Schnittstellen kann abgerufen werden, indem Sie die Funktion WZCEnumInterfaces aufrufen.

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

Weitere Informationen

WZCEapolGetInterfaceParams
WZCEnumInterfaces
WZCQueryInterface
INTF_ENTRY

Freigeben über