Funzione WZCQueryInterface

Articolo
06/13/2023

[WZCQueryInterface non è più supportato a partire da Windows Vista e Windows Server 2008. Usare invece la funzione WlanQueryInterface . Per altre informazioni, vedere Informazioni sull'API Wifi nativa. ]

La funzione WZCQueryInterface fornisce informazioni dettagliate per un'interfaccia LAN wireless gestita dal servizio Wireless Zero Configuration.

Fornisce informazioni dettagliate per un'interfaccia specificata.

Sintassi

DWORD WZCQueryInterface(
  _In_    LPWSTR      pSrvAddr,
  _In_    DWORD       dwInFlags,
  _Inout_ 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 sottoposto a query nel computer locale.

Se il parametro pSrvAddr specificato è un computer remoto, il computer remoto deve supportare chiamate RPC remote.

dwInFlags [in]

Campi da eseguire query. Questa è una maschera bit che può contenere qualsiasi combinazione dei flag seguenti.

Valore	Significato
INTF_DYNFLAGS 0x00000010	Restituisce il valore per il membro dwDynFlags nella struttura INTF_ENTRY a cui punta il parametro pIntf .
INTF_DESCR 0x00010000	Restituisce il valore per il membro wszDescr nella struttura INTF_ENTRY a cui punta il parametro pIntf .
INTF_NDISMEDIA 0x00020000	Restituisce i valori per i membri ulMediaState, ulMediaType e ulPhysicalMediaType nella struttura INTF_ENTRY a cui punta il parametro pIntf.
INTF_PREFLIST 0x00040000	Restituisce l'elenco preferito di reti nel membro rdStSSIDList della struttura INTF_ENTRY a cui punta il parametro pIntf .
INTF_CAPABILITIES 0x00080000	Restituisce i valori per i membri dwCapabilities e rdNicCapabilities nella struttura INTF_ENTRY a cui punta il parametro pIntf .
INTF_INFRAMODE 0x00200000	Restituisce il valore per il membro nInfraMode nella struttura INTF_ENTRY a cui punta il parametro pIntf . Il membro nInfraMode è valido solo in alcuni stati di contesto dell'interfaccia.
INTF_AUTHMODE 0x00400000	Restituisce il valore per il membro nAuthMode nella struttura INTF_ENTRY a cui punta il parametro pIntf . Il membro nAuthMode è valido solo in alcuni stati di contesto dell'interfaccia.
INTF_WEPSTATUS 0x00800000	Restituisce il valore per il membro nWepStatus nella struttura INTF_ENTRY a cui punta il parametro pIntf . Il membro nWepStatus è valido solo in alcuni stati di contesto dell'interfaccia.
INTF_SSID 0x01000000	Restituisce il valore per il membro rdSSID nella struttura INTF_ENTRY a cui punta il parametro pIntf . Il membro rdSSID è valido solo in alcuni stati di contesto dell'interfaccia.
INTF_BSSID 0x02000000	Restituisce il valore per il membro rdBSSID nella struttura INTF_ENTRY a cui punta il parametro pIntf . Il membro rdBSSID è valido solo in alcuni stati di contesto dell'interfaccia.
INTF_BSSIDLIST 0x04000000	Restituisce l'elenco visibile delle reti nel membro rdBSSIDList della struttura INTF_ENTRY a cui punta il parametro pIntf . Il membro rdBSSIDList è valido solo in alcuni stati di contesto dell'interfaccia.

pIntf [in, out]

In input, un puntatore alla chiave dell'interfaccia da eseguire una query. In output, un puntatore ai dati dell'interfaccia richiesti. Questo parametro è un puntatore a una struttura INTF_ENTRY .

pdwOutFlags [out]

Set di campi recuperati 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
ERROR_ARENA_TRASHED	I blocchi di controllo di archiviazione sono stati eliminati. Questo errore viene restituito se il servizio Wireless Zero Configuration non ha inizializzato oggetti interni.
ERROR_FILE_NOT_FOUND	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.
ERROR_INVALID_PARAMETER	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.
ERROR_NOT_ENOUGH_MEMORY	Memoria insufficiente per elaborare questa richiesta e allocare memoria per i risultati della query.
RPC_STATUS	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 .

I membri seguenti della struttura INTF_ENTRY puntati da pIntf devono essere impostati su 0 prima di una chiamata alla funzione WZCQueryInterface: rdSSID, rdBSSID, rdBSSIDList, rdStSSIDList e rdCtrlData.

Il servizio Wireless Zero Configuration non aggiorna automaticamente lo stato multimediale, anche quando vengono ricevuti eventi multimediali connessi e disconnessi. Un'applicazione deve forzare un aggiornamento dello stato multimediale chiamando la funzione WZCRefreshInterface prima di chiamare la funzione WZCQueryInterface se lo stato del supporto NDIS deve essere richiesto (il bit INTF_NDISMEDIA verrà impostato nel parametro dwInFlags ).

Quando il parametro dwInFlags contiene INTF_BSSIDLIST, la funzione WZCQueryInterface non imposta i dwOutFlags con INTF_BSSIDLIST se l'elenco visibile delle reti è vuoto. Quando il parametro dwInFlags contiene INTF_SSID, la funzione WZCQueryInterface non imposta i dwOutFlags con INTF_SSID se non è disponibile SSID.

Se la funzione WZCQueryInterface restituisce ERROR_SUCCESS, il chiamante deve chiamare la funzione LocalFree con il parametro pIntf per rilasciare i buffer interni allocati per i dati restituiti una volta che queste informazioni non sono più necessarie. In questo modo vengono rilasciati i buffer usati dai membri rdSSID, rdBSSID, rdBSSIDList, rdStSSIDList e rdCtrlData della struttura INTF_ENTRY a cui fa riferimento il parametro pIntf.

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	Wzcsapi.h
Libreria	Wzcsapi.lib
DLL	Wzcsapi.dll

Vedi anche

INTF_ENTRY
WZCEapolGetInterfaceParams
WZCEnumInterfaces
WZCRefreshInterface

Condividi tramite