Função WlanOpenHandle (wlanapi.h)

  • Artigo

A função WlanOpenHandle abre uma conexão com o servidor.

Sintaxe

DWORD WlanOpenHandle(
  [in]  DWORD   dwClientVersion,
        PVOID   pReserved,
  [out] PDWORD  pdwNegotiatedVersion,
  [out] PHANDLE phClientHandle
);

Parâmetros

[in] dwClientVersion

A versão mais alta da API WLAN à qual o cliente dá suporte.

Valor Significado
1
 Versão do cliente para Windows XP com SP3 e API lan sem fio para Windows XP com SP2.
2
 Versão do cliente para Windows Vista e Windows Server 2008

pReserved

Reservado para uso futuro. Deve ser definido como NULL.

[out] pdwNegotiatedVersion

A versão da API WLAN que será usada nesta sessão. Esse valor geralmente é a versão mais alta com suporte do cliente e do servidor.

[out] phClientHandle

Um identificador para o cliente usar nesta sessão. Esse identificador é usado por outras funções durante toda a sessão.

Valor retornado

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
 pdwNegotiatedVersion é NULL, phClientHandle é NULL ou pReserved não é NULL.
ERROR_NOT_ENOUGH_MEMORY
 Falha ao alocar memória para criar o contexto do cliente.
RPC_STATUS
 Vários códigos de erro.
ERROR_REMOTE_SESSION_LIMIT_EXCEEDED
 Muitos identificadores foram emitidos pelo servidor.

Comentários

O número de versão especificado por dwClientVersion e pdwNegotiatedVersion é um número de versão composto composto por versões principais e secundárias. A versão principal é especificada pela palavra de baixa ordem e a versão secundária é especificada pela palavra de alta ordem. As macros WLAN_API_VERSION_MAJOR(_v) e WLAN_API_VERSION_MINOR(_v) retornam os números de versão principal e secundária, respectivamente. Você pode construir um número de versão usando a macro WLAN_API_MAKE_VERSION(_major, _minor).

Windows XP com SP3 e API lan sem fio para Windows XP com SP2: WlanOpenHandle retornará uma mensagem de erro se o serviço WZC (Wireless Zero Configuration) não tiver sido iniciado ou se o serviço WZC não estiver respondendo.

Requisitos

   
Cliente mínimo com suporte Windows Vista, Windows XP com SP3 [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
Redistribuível API de LAN sem fio para Windows XP com SP2

Confira também

WlanCloseHandle