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

El método IWCNDevice::SetPassword configura el valor del método de autenticación y, si es necesario, una contraseña usada para la sesión pendiente. Solo se puede llamar a este método antes de IWCNDevice::Connect.

Sintaxis

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

Parámetros

[in] Type

Valor WCN_PASSWORD_TYPE que especifica el método de autenticación utilizado para la sesión.

Valor	Significado
WCN_PASSWORD_TYPE_PUSH_BUTTON	Use la autenticación PushButton. El valor de dwPasswordLength debe ser NULL.
WCN_PASSWORD_TYPE_PIN	Use la autenticación basada en PIN.

[in] dwPasswordLength

Número de bytes del búfer pbPassword.

[in] pbPassword

Matriz de bytes de la contraseña, codificada en ASCII.

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto	Descripción
S_OK	La contraseña se usará para la sesión pendiente.
E_INVALIDARG	El tipo de contraseña es WCN_PASSWORD_TYPE_PUSH_BUTTON y la longitud de la contraseña no es cero. El tipo de contraseña no es WCN_PASSWORD_TYPE_PUSH_BUTTON ni WCN_PASSWORD_TYPE_PIN.

Comentarios

La matriz de bytes no termina en NULL. Por ejemplo, si la contraseña es un PIN de 4 dígitos, debe pasar dwPasswordLength como 4 y pbPassword debe apuntar a una matriz de 4 bytes que contenga el PIN en ASCII.

Requisitos

Cliente mínimo compatible	Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible	No se admite ninguno
Plataforma de destino	Windows
Encabezado	wcndevice.h

Consulte también

IWCNDevice

IWCNDevice::Connect

WCN_PASSWORD_TYPE