WCNDevice::SetPassword メソッド (wcndevice.h)

HTTPNDevice::SetPassword メソッドは、認証方法の値を構成し、必要に応じて、保留中のセッションに使用されるパスワードを構成します。このメソッドは、 VWNDevice::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で、パスワードの長さが 0 ではありません。パスワードの種類がWCN_PASSWORD_TYPE_PUSH_BUTTONまたはWCN_PASSWORD_TYPE_PINされていません。

バイト配列は NULL で終わるものではありません。たとえば、パスワードが 4 桁の PIN の場合は、dwPasswordLength を 4 として渡し、pbPassword は ASCII の PIN を含む 4 バイト配列を指す必要があります。