IWCNDevice::SetPassword 方法 (wcndevice.h)

IWCNDevice::SetPassword 方法配置身份验证方法值,并根据需要配置用于挂起会话的密码。 只能在 IWCNDevice::Connect 之前调用此方法。

语法

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

参数

[in] Type

一个 WCN_PASSWORD_TYPE 值,该值指定用于会话的身份验证方法。

含义
WCN_PASSWORD_TYPE_PUSH_BUTTON
使用 PushButton 身份验证。 dwPasswordLength 的值必须为 NULL
WCN_PASSWORD_TYPE_PIN
使用基于 PIN 的身份验证。

[in] dwPasswordLength

缓冲区 pbPassword 中的字节数。

[in] pbPassword

密码的字节数组,以 ASCII 编码。

返回值

此方法可以返回其中一个值。

返回代码 说明
S_OK
密码将用于挂起的会话。
E_INVALIDARG
密码类型WCN_PASSWORD_TYPE_PUSH_BUTTON密码长度不为零。

密码类型不是WCN_PASSWORD_TYPE_PUSH_BUTTON或WCN_PASSWORD_TYPE_PIN。

注解

字节数组不是 以 NULL 结尾的。 例如,如果密码是 4 位 PIN,则应将 dwPasswordLength 作为 4 传递,pbPassword 应指向包含 ASCII 中的 PIN 的 4 字节数组。

要求

   
最低受支持的客户端 Windows 7 [仅限桌面应用]
最低受支持的服务器 无受支持的版本
目标平台 Windows
标头 wcndevice.h

另请参阅

IWCNDevice

IWCNDevice::Connect

WCN_PASSWORD_TYPE