Compartilhar via

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

  • Artigo

O método IWCNDevice::SetPassword configura o valor do método de autenticação e, se necessário, uma senha usada para a sessão pendente. Esse método só pode ser chamado antes de IWCNDevice::Connect.

Sintaxe

HRESULT SetPassword(
  [in] WCN_PASSWORD_TYPE Type,
  [in] DWORD             dwPasswordLength,
  [in] const BYTE []     pbPassword
);

Parâmetros

[in] Type

Um valor WCN_PASSWORD_TYPE que especifica o método de autenticação usado para a sessão.

Valor Significado
WCN_PASSWORD_TYPE_PUSH_BUTTON
 Use a autenticação PushButton. O valor de dwPasswordLength deve ser NULL.
WCN_PASSWORD_TYPE_PIN
 Use a autenticação baseada em PIN.

[in] dwPasswordLength

Número de bytes no buffer pbPassword.

[in] pbPassword

Uma matriz de bytes da senha, codificada em ASCII.

Valor retornado

Esse método pode retornar um desses valores.

Código de retorno Descrição
S_OK
 A senha será usada para a sessão pendente.
E_INVALIDARG
 O tipo de senha é WCN_PASSWORD_TYPE_PUSH_BUTTON e o comprimento da senha não é zero.

O tipo de senha não é WCN_PASSWORD_TYPE_PUSH_BUTTON ou WCN_PASSWORD_TYPE_PIN.

Comentários

A matriz de bytes não é terminada em NULL. Por exemplo, se a senha for um PIN de 4 dígitos, você deverá passar dwPasswordLength como 4 e pbPassword deverá apontar para uma matriz de 4 bytes que contém o PIN em ASCII.

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

IWCNDevice::Connect

WCN_PASSWORD_TYPE