Fonction WZCQueryInterface
[WZCQueryInterface n’est plus pris en charge depuis Windows Vista et Windows Server 2008. Utilisez la fonction WlanQueryInterface à la place. Pour plus d’informations, consultez À propos de l’API Wifi native. ]
La fonction WZCQueryInterface fournit des informations détaillées pour une interface LAN sans fil gérée par le service Configuration zéro sans fil.
Fournit des informations détaillées pour une interface donnée.
Syntaxe
DWORD WZCQueryInterface(
_In_ LPWSTR pSrvAddr,
_In_ DWORD dwInFlags,
_Inout_ PINTF_ENTRY pIntf,
_Out_ LPDWORD pdwOutFlags
);
Paramètres
-
pSrvAddr [in]
-
Pointeur vers une chaîne contenant le nom de l’ordinateur sur lequel exécuter cette fonction. Si ce paramètre a la valeur NULL, le service Configuration zéro sans fil est interrogé sur l’ordinateur local.
Si le paramètre pSrvAddr spécifié est un ordinateur distant, l’ordinateur distant doit prendre en charge les appels RPC distants.
-
dwInFlags [in]
-
Champs à interroger. Il s’agit d’un masque de bits qui peut contenir n’importe quelle combinaison des indicateurs suivants.
Valeur Signification - INTF_DYNFLAGS
- 0x00000010
Retourne la valeur du membre dwDynFlags dans la structure INTF_ENTRY pointée vers le paramètre pIntf . - INTF_DESCR
- 0x00010000
Retourne la valeur du membre wszDescr dans la structure INTF_ENTRY pointée vers le paramètre pIntf . - INTF_NDISMEDIA
- 0x00020000
Retourne les valeurs des membres ulMediaState, ulMediaType et ulPhysicalMediaType dans la structure INTF_ENTRY pointée vers le paramètre pIntf . - INTF_PREFLIST
- 0x00040000
Retourne la liste préférée des réseaux dans le membre rdStSSIDList de la structure INTF_ENTRY pointée vers le paramètre pIntf . - INTF_CAPABILITIES
- 0x00080000
Retourne les valeurs des membres dwCapabilities et rdNicCapabilities dans la structure INTF_ENTRY pointée par le paramètre pIntf . - INTF_INFRAMODE
- 0x00200000
Retourne la valeur du membre nInfraMode dans la structure INTF_ENTRY pointée par le paramètre pIntf .
Le membre nInfraMode n’est valide que dans certains états de contexte d’interface.- INTF_AUTHMODE
- 0x00400000
Retourne la valeur du membre nAuthMode dans la structure INTF_ENTRY pointée vers le paramètre pIntf .
Le membre nAuthMode est valide uniquement dans certains états de contexte d’interface.- INTF_WEPSTATUS
- 0x00800000
Retourne la valeur du membre nWepStatus dans la structure INTF_ENTRY pointée vers le paramètre pIntf .
Le membre nWepStatus est valide uniquement dans certains états de contexte d’interface.- INTF_SSID
- 0x01000000
Retourne la valeur du membre rdSSID dans la structure INTF_ENTRY pointée par le paramètre pIntf .
Le membre rdSSID est valide uniquement dans certains états de contexte d’interface.- INTF_BSSID
- 0x02000000
Retourne la valeur du membre rdBSSID dans la structure INTF_ENTRY pointée par le paramètre pIntf .
Le membre rdBSSID est valide uniquement dans certains états de contexte d’interface.- INTF_BSSIDLIST
- 0x04000000
Retourne la liste visible des réseaux dans le membre rdBSSIDList de la structure INTF_ENTRY pointée vers le paramètre pIntf .
Le membre rdBSSIDList est valide uniquement dans certains états de contexte d’interface. -
pIntf [in, out]
-
En entrée, pointeur vers la clé de l’interface à interroger. En sortie, pointeur vers les données d’interface demandées. Ce paramètre est un pointeur vers une structure INTF_ENTRY .
-
pdwOutFlags [out]
-
Ensemble de champs récupérés avec succès.
Valeur retournée
Si la fonction réussit, la valeur de retour est ERROR_SUCCESS.
Si la fonction échoue, la valeur de retour peut être l’un des codes de retour suivants.
| Code de retour | Description |
|---|---|
|
Les blocs de contrôle de stockage ont été détruits. Cette erreur est retournée si le service Wireless Zero Configuration n’a pas initialisé d’objets internes. |
|
Le système ne peut pas trouver le fichier spécifié. Cette erreur est retournée si le GUID dans le membre wszGuid de la structure INTF_ENTRY pointée par le paramètre pIntf ne correspondait à aucune des interfaces LAN sans fil sur l’ordinateur local. |
|
Un paramètre est incorrect. Cette erreur est retournée si le paramètre pIntf a la valeur NULL. Cette erreur est retournée si le membre wszGuid de la structure INTF_ENTRY pointée vers le paramètre pIntf est NULL. |
|
La mémoire disponible est insuffisante pour traiter cette demande et allouer de la mémoire pour les résultats de la requête. |
|
Différents codes d’erreur. |
Notes
Le membre wszGuid de la structure INTF_ENTRY pointée vers le paramètre pIntf doit contenir un GUID d’interface pour une interface LAN sans fil. Une liste d’interfaces LAN sans fil peut être récupérée en appelant la fonction WZCEnumInterfaces .
Les membres suivants de la structure INTF_ENTRY pointées par pIntf doivent avoir la valeur 0 avant d’appeler la fonction WZCQueryInterface : rdSSID, rdBSSID, rdBSSIDList, rdStSSIDList et rdCtrlData.
Le service Configuration zéro sans fil ne met pas à jour automatiquement l’état du média, même lorsque des événements connectés et déconnectés multimédias sont reçus. Une application doit forcer une actualisation de l’état du média en appelant la fonction WZCRefreshInterface avant d’appeler la fonction WZCQueryInterface si l’état du média NDIS doit être demandé (le bit INTF_NDISMEDIA sera défini dans le paramètre dwInFlags ).
Lorsque le paramètre dwInFlags contient INTF_BSSIDLIST, la fonction WZCQueryInterface ne définit pas dwOutFlags avec INTF_BSSIDLIST si la liste visible des réseaux est vide. Lorsque le paramètre dwInFlags contient INTF_SSID, la fonction WZCQueryInterface ne définit pas dwOutFlags avec INTF_SSID si aucun SSID n’est disponible.
Si la fonction WZCQueryInterface retourne ERROR_SUCCESS, l’appelant doit appeler la fonction LocalFree avec le paramètre pIntf pour libérer les mémoires tampons internes allouées pour les données retournées une fois que ces informations ne sont plus nécessaires. Cela libère les mémoires tampons utilisées par les membres rdSSID, rdBSSID, rdBSSIDList, rdStSSIDList et rdCtrlData de la structure INTF_ENTRY pointée vers le paramètre pIntf .
Notes
Le fichier d’en-tête Wzcsapi.h et le fichier de bibliothèque d’importation Wzcsapi.lib ne sont pas disponibles dans le Kit de développement logiciel (SDK) Windows.
Spécifications
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows XP avec SP2 [applications de bureau uniquement] |
| Serveur minimal pris en charge |
Windows Server 2003 [applications de bureau uniquement] |
| Fin de la prise en charge des clients |
Windows XP avec SP3 |
| Fin de la prise en charge des serveurs |
Windows Server 2003 |
| En-tête |
|
| Bibliothèque |
|
| DLL |
|
Voir aussi