ISCardVerify::ChangeCode メソッド
[ ChangeCode メソッドは、[要件] セクションで指定したオペレーティング システムで使用できます。 Windows Server 2003 Service Pack 1 (SP1) 以降、Windows Vista、Windows Server 2008、および以降のバージョンのオペレーティング システムでは使用できません。 スマート カード モジュールも同様の機能を提供します。
ChangeCode メソッドは、現在の CHV (カード所有者検証) コードを新しい CHV コードに置き換えます。
構文
HRESULT ChangeCode(
[in] LPBYTEBUFFER pOldCode,
[in] LPBYTEBUFFER pNewCode,
[in] SCARD_FLAGS Flags,
[in] LONG lRef
);
パラメーター
-
pOldCode [in]
-
ユーザーの現在のコードを含む IByteBuffer へのポインター。
-
pNewCode [in]
-
ユーザーを認証するための変更プロセス中にスマート カードに提示される新しいコードを含む IByteBuffer へのポインター。
-
Flags [in]
-
コードがグローバルかローカルか、およびコードを有効または無効にするかどうかを示します。
-
SC_FL_IHV_GLOBAL
-
SC_FL_IHV_LOCAL
-
SC_FL_IHV_ENABLE
-
SC_FL_IHV_DISABLE
-
-
lRef [in]
-
スマート カード固有の参照。
戻り値
メソッドは、次のいずれかの値を返します。
| リターン コード | 説明 |
|---|---|
|
操作は正常に完了しました。 |
|
無効なパラメーター。 |
|
不適切なポインターが渡されました。 |
|
メモリが不足しています。 |
解説
このインターフェイスで定義されているすべてのメソッドの一覧については、「 ISCardVerify」を参照してください。
上記の COM エラー コードに加えて、要求を完了するためにスマート カード関数が呼び出された場合、このインターフェイスはスマート カード エラー コードを返す場合があります。 詳細については、「 スマート カードの戻り値」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows XP [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
Windows Server 2003 [デスクトップ アプリのみ] |
| クライアント サポートの終了 |
Windows XP |
| サーバー サポートの終了 |
Windows Server 2003 |
関連項目