Compartilhar via

Método IWCNDevice::SetNetworkProfile (wcndevice.h)

  • Artigo

O método IWCNDevice::SetNetworkProfile enfileira um perfil WLAN XML a ser provisionado para o dispositivo. Esse método só pode ser chamado antes de IWCNDevice::Connect.

Sintaxe

HRESULT SetNetworkProfile(
  [in] LPCWSTR pszProfileXml
);

Parâmetros

[in] pszProfileXml

A cadeia de caracteres XML do perfil WLAN XML.

Valor retornado

Esse método pode retornar um desses valores.

Código de retorno Descrição
S_OK
 O atributo foi recuperado com êxito.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)
 Não há suporte para o perfil WLAN para conexões WCN.
HRESULT_FROM_WIN32(ERROR_BAD_PROFILE)
 O perfil XML fornecido não pode ser lido.

Comentários

Atualmente, a API de Conexão Fácil do Windows (WCNAPI) dá suporte aos seguintes tipos de perfil:

  • Nenhum (Aberto ou Compartilhado)
  • WEP (aberto ou compartilhado)
  • WPA-PSK (TKIP ou AES)
  • WPA2-PSK (TKIP ou AES)
Se o perfil WLAN especificado tiver configurações desnecessárias (como configurações de IHV), essas configurações serão ignoradas. Caso um perfil WLAN não seja compatível com o WCNAPI, um valor de HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED) será retornado.

Requisitos

   
Cliente mínimo com suporte Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Nenhum compatível
Plataforma de Destino Windows
Cabeçalho wcndevice.h

Confira também

IWCNDevice