WZCRefreshInterface, fonction
[WZCRefreshInterface n’est pas pris en charge à partir de Windows Vista et Windows Server 2008. Utilisez plutôt l’API Wifi native, qui fournit des fonctionnalités similaires. Pour plus d’informations, consultez À propos de l’API Wifi native.]
La fonction WZCRefreshInterface actualise les informations d’interface pour une interface LAN sans fil spécifique.
Syntaxe
DWORD WZCRefreshInterface(
_In_ LPWSTR pSrvAddr,
_In_ DWORD dwInFlags,
_In_ 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 Wireless Zero Configuration est appelé 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]
-
Ensemble de champs à actualiser, ainsi que des actions d’actualisation spécifiques à effectuer. Il s’agit d’un masque de bits qui peut contenir n’importe quelle combinaison des indicateurs suivants.
Valeur Signification - INTF_DESCR
- 0x00010000
Actualisez la description de l’interface pour une interface LAN sans fil.
La description de l’interface actualisée peut être récupérée en appelant la fonction WZCQueryInterface avec le bit INTF_DESCR défini dans le paramètre dwInFlags . La description de l’interface est retournée dans le membre wszDescr de la structure INTF_ENTRY pointée par le paramètre pIntf retourné par la fonction WZCQueryInterface .- INTF_NDISMEDIA
- 0x00020000
Actualisez les informations du média NDIS pour une interface LAN sans fil.
Les informations de média NDIS actualisées peuvent être récupérées en appelant la fonction WZCQueryInterface avec le bit INTF_NDISMEDIA défini dans le paramètre dwInFlags . Les informations du média NDIS sont retournées dans les membres ulMediaState, ulMediaType et ulPhysicalMediaType de la structure INTF_ENTRY pointée vers laquelle pointe le paramètre pIntf retourné par la fonction WZCQueryInterface .- INTF_ALL_OIDS
- 0xFFF00000
Actualisez tous les OID NDIS pour une interface LAN sans fil. Cette option actualise la plupart des données d’une interface LAN sans fil.
Les informations actualisées peuvent être récupérées en appelant la fonction WZCQueryInterface . -
pIntf [in]
-
Pointeur vers une structure INTF_ENTRY qui contient la clé de l’interface à actualiser.
-
pdwOutFlags [out]
-
Ensemble de champs qui ont été correctement actualisé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 correspond à 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 par le paramètre pIntf est NULL. |
|
Différents codes d’erreur. |
Notes
Le membre wszGuid de la structure INTF_ENTRY pointée par 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 .
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