Função WlanIhvControl (wlanapi.h)

Artigo
03/04/2024

A função WlanIhvControl fornece um mecanismo para controle IHV (fornecedor independente de hardware) de drivers ou serviços WLAN.

Sintaxe

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
);

Parâmetros

[in] hClientHandle

O identificador de sessão do cliente, obtido por uma chamada anterior para a função WlanOpenHandle .

[in] pInterfaceGuid

O GUID da interface.

[in] Type

Uma estrutura WLAN_IHV_CONTROL_TYPE que especifica o tipo de software ignorado pela função de controle IHV.

[in] dwInBufferSize

O tamanho, em bytes, do buffer de entrada.

[in] pInBuffer

Um buffer genérico para entrada de driver ou interface de serviço.

[in] dwOutBufferSize

O tamanho, em bytes, do buffer de saída.

[in, out, optional] pOutBuffer

Um buffer genérico para saída de driver ou interface de serviço.

[out] pdwBytesReturned

O número de bytes retornados.

Retornar valor

Se a função obtiver êxito, o valor retornado será ERROR_SUCCESS.

Se a função falhar, o valor retornado poderá ser um dos seguintes códigos de retorno.

Código de retorno	Descrição
ERROR_ACCESS_DENIED	O chamador não tem permissões suficientes para executar essa operação. Quando chamado, WlanIhvControl recupera a DACL (lista de controle de acesso discricionário) armazenada com o objeto wlan_secure_ihv_control . Se a DACL não contiver uma ACE (entrada de controle de acesso) que conceda permissão WLAN_WRITE_ACCESS ao token de acesso do thread de chamada, WlanIhvControl retornará ERROR_ACCESS_DENIED.
ERROR_INVALID_PARAMETER	hClientHandle é NULL ou inválido, pInterfaceGuid é NULL ou pdwBytesReturned é NULL.
ERROR_INVALID_HANDLE	O identificador hClientHandle não foi encontrado na tabela de identificadores.
ERROR_NOT_SUPPORTED	Essa função foi chamada de uma plataforma sem suporte. Esse valor será retornado se essa função for chamada de um Windows XP com SP3 ou API lan sem fio para Windows XP com cliente SP2.
RPC_STATUS	Vários códigos de erro.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	wlanapi.h (inclua Wlanapi.h)
Biblioteca	Wlanapi.lib
DLL	Wlanapi.dll

Confira também

WLAN_IHV_CONTROL_TYPE

Compartilhar via