Função WlanGetInterfaceCapability (wlanapi.h)

  • Artigo

A função WlanGetInterfaceCapability recupera os recursos de uma interface.

Sintaxe

DWORD WlanGetInterfaceCapability(
  [in]  HANDLE                     hClientHandle,
  [in]  const GUID                 *pInterfaceGuid,
        PVOID                      pReserved,
  [out] PWLAN_INTERFACE_CAPABILITY *ppCapability
);

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 dessa interface.

pReserved

Reservado para uso futuro. Deve ser definido como NULL.

[out] ppCapability

Uma estrutura WLAN_INTERFACE_CAPABILITY que contém informações sobre os recursos da interface especificada.

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_INVALID_PARAMETER
 hClientHandle é NULL ou inválido, pInterfaceGuid é NULL, pReserved não é NULL ou ppCapability é NULL.
ERROR_INVALID_HANDLE
 O identificador hClientHandle não foi encontrado na tabela de identificador.
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.

Comentários

O chamador é responsável por chamar a função WlanFreeMemory para liberar a memória alocada para ppCapability.

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