Funzione WZCRefreshInterface
[WZCRefreshInterface non è supportato a partire da Windows Vista e Windows Server 2008. Usare invece l'API Native Wifi, che offre funzionalità simili. Per altre informazioni, vedere Informazioni sull'API Wifi nativa.
La funzione WZCRefreshInterface aggiorna le informazioni sull'interfaccia per un'interfaccia LAN wireless specifica.
Sintassi
DWORD WZCRefreshInterface(
_In_ LPWSTR pSrvAddr,
_In_ DWORD dwInFlags,
_In_ PINTF_ENTRY pIntf,
_Out_ LPDWORD pdwOutFlags
);
Parametri
-
pSrvAddr [in]
-
Puntatore a una stringa contenente il nome del computer in cui eseguire questa funzione. Se questo parametro è NULL, il servizio Wireless Zero Configuration viene chiamato nel computer locale.
Se il parametro pSrvAddr specificato è un computer remoto, il computer remoto deve supportare chiamate RPC remote.
-
dwInFlags [in]
-
Set di campi da aggiornare insieme a azioni di aggiornamento specifiche da eseguire. Questa è una maschera bit che può contenere qualsiasi combinazione dei flag seguenti.
Valore Significato - INTF_DESCR
- 0x00010000
Aggiornare la descrizione dell'interfaccia per un'interfaccia LAN wireless.
La descrizione dell'interfaccia aggiornata può essere recuperata chiamando la funzione WZCQueryInterface con il INTF_DESCR bit impostato nel parametro dwInFlags . La descrizione dell'interfaccia viene restituita nel membro wszDescr della struttura INTF_ENTRY puntata dal parametro pIntf restituito dalla funzione WZCQueryInterface .- INTF_NDISMEDIA
- 0x00020000
Aggiornare le informazioni multimediali NDIS per un'interfaccia LAN wireless.
Le informazioni multimediali NDIS aggiornate possono essere recuperate chiamando la funzioneWZCQueryInterface con il INTF_NDISMEDIA bit impostato nel parametro dwInFlags. Le informazioni sui supporti NDIS vengono restituite nei membri ulMediaState, ulMediaType e ulPhysicalMediaType della struttura INTF_ENTRY a cui fa riferimento il parametro pIntf restituito dalla funzione WZCQueryInterface .- INTF_ALL_OIDS
- 0xFFF00000
Aggiornare tutti gli ID NDIS per un'interfaccia LAN wireless. Questa opzione aggiorna la maggior parte dei dati per un'interfaccia LAN wireless.
Le informazioni aggiornate possono essere recuperate chiamando la funzione WZCQueryInterface . -
pIntf [in]
-
Puntatore a una struttura INTF_ENTRY che contiene la chiave dell'interfaccia da aggiornare.
-
pdwOutFlags [out]
-
Set di campi che sono stati aggiornati correttamente.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è ERROR_SUCCESS.
Se la funzione ha esito negativo, il valore restituito può essere uno dei codici restituiti seguenti.
| Codice restituito | Descrizione |
|---|---|
|
I blocchi di controllo di archiviazione sono stati eliminati. Questo errore viene restituito se il servizio Wireless Zero Configuration non ha inizializzato oggetti interni. |
|
Non è possibile trovare il file specificato. Questo errore viene restituito se il GUID nel membro wszGuid della struttura INTF_ENTRY punta al parametro pIntf non corrispondeva a nessuna delle interfacce LAN wireless nel computer locale. |
|
Un parametro non è corretto. Questo errore viene restituito se il parametro pIntf è NULL. Questo errore viene restituito se il membro wszGuid della struttura INTF_ENTRY puntato dal parametro pIntf è NULL. |
|
Vari codici di errore. |
Commenti
Il membro wszGuid della struttura INTF_ENTRY a cui punta il parametro pIntf deve contenere un GUID dell'interfaccia per un'interfaccia LAN wireless. È possibile recuperare un elenco di interfacce LAN wireless chiamando la funzione WZCEnumInterfaces .
Nota
Il file di intestazione Wzcsapi.h e il file di libreria di importazione Wzcsapi.lib non sono disponibili in Windows SDK.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato |
Windows XP con SP2 [solo app desktop] |
| Server minimo supportato |
Windows Server 2003 [solo app desktop] |
| Fine del supporto client |
Windows XP con SP3 |
| Fine del supporto server |
Windows Server 2003 |
| Intestazione |
|
| Libreria |
|
| DLL |
|
Vedi anche