Fonction WlanIhvControl (wlanapi.h)

Article
03/04/2024

La fonction WlanIhvControl fournit un mécanisme pour le contrôle IHV (fournisseur de matériel indépendant) des pilotes ou services WLAN.

Syntaxe

DWORD WlanIhvControl(
  [in]                HANDLE                hClientHandle,
  [in]                const GUID            *pInterfaceGuid,
  [in]                WLAN_IHV_CONTROL_TYPE Type,
  [in]                DWORD                 dwInBufferSize,
  [in]                PVOID                 pInBuffer,
  [in]                DWORD                 dwOutBufferSize,
  [in, out, optional] PVOID                 pOutBuffer,
  [out]               PDWORD                pdwBytesReturned
);

Paramètres

[in] hClientHandle

Le handle de session du client, obtenu par un appel précédent à la fonction WlanOpenHandle .

[in] pInterfaceGuid

GUID de l’interface.

[in] Type

Une structure WLAN_IHV_CONTROL_TYPE qui spécifie le type de logiciel contourné par la fonction de contrôle IHV.

[in] dwInBufferSize

Taille, en octets, de la mémoire tampon d’entrée.

[in] pInBuffer

Mémoire tampon générique pour l’entrée du pilote ou de l’interface de service.

[in] dwOutBufferSize

Taille, en octets, de la mémoire tampon de sortie.

[in, out, optional] pOutBuffer

Mémoire tampon générique pour la sortie du pilote ou de l’interface de service.

[out] pdwBytesReturned

Nombre d’octets retourné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
ERROR_ACCESS_DENIED	L’appelant ne dispose pas des autorisations suffisantes pour effectuer cette opération. Lorsqu’il est appelé, WlanIhvControl récupère la liste de contrôle d’accès discrétionnaire (DACL) stockée avec l’objet wlan_secure_ihv_control . Si la LISTE de contrôle d’accès ne contient pas d’entrée de contrôle d’accès (ACE) qui accorde à WLAN_WRITE_ACCESS l’autorisation d’accès au jeton d’accès du thread appelant, WlanIhvControl retourne ERROR_ACCESS_DENIED.
ERROR_INVALID_PARAMETER	hClientHandle a la valeur NULL ou non valide, pInterfaceGuid a la valeur NULL ou pdwBytesReturned a la valeur NULL.
ERROR_INVALID_HANDLE	Le handle hClientHandle est introuvable dans la table handle.
ERROR_NOT_SUPPORTED	Cette fonction a été appelée à partir d’une plateforme non prise en charge. Cette valeur sera retournée si cette fonction a été appelée à partir d’un windows XP avec l’API LAN sans fil ou SP3 pour Windows XP avec le client SP2.
RPC_STATUS	Différents codes d’erreur.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	wlanapi.h (inclure Wlanapi.h)
Bibliothèque	Wlanapi.lib
DLL	Wlanapi.dll

Voir aussi

WLAN_IHV_CONTROL_TYPE

Partager via