Função WlanOpenHandle (wlanapi.h)
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 |
|---|---|
|
Versão do cliente para Windows XP com SP3 e API lan sem fio para Windows XP com SP2. |
|
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 |
|---|---|
|
pdwNegotiatedVersion é NULL, phClientHandle é NULL ou pReserved não é NULL. |
|
Falha ao alocar memória para criar o contexto do cliente. |
|
Vários códigos de erro. |
|
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 |