ISCardCmd::p ut_P1 メソッド
[ put_P1 メソッドは、[要件] セクションで指定したオペレーティング システムで使用できます。 Windows Server 2003 Service Pack 1 (SP1) 以降、Windows Vista、Windows Server 2008、および以降のバージョンのオペレーティング システムでは使用できません。 スマート カード モジュールも同様の機能を提供します。
put_P1 メソッドは、アプリケーション プロトコル データ ユニット (APDU) の最初のパラメーター (P1) バイトを設定します。
構文
HRESULT put_P1(
[in] BYTE byP1
);
パラメーター
-
byP1 [in]
-
P1 フィールドであるバイト。
戻り値
メソッドは、次のいずれかの値を返します。
| リターン コード | 説明 |
|---|---|
|
操作は正常に完了しました。 |
|
byP1 パラメーターが無効です。 |
|
メモリが不足しています。 |
解説
APDU の P2 値を設定するには、 get_P2を呼び出します。
既存の P1、P2、および P3 の値を取得するには、それぞれ get_P1、 get_P2 、または get_P3 を呼び出します。
このインターフェイスによって提供されるすべてのメソッドの一覧については、「 ISCardCmd」を参照してください。
上記の COM エラー コードに加えて、要求を完了するためにスマート カード関数が呼び出された場合、このインターフェイスはスマート カード エラー コードを返す場合があります。 詳細については、「 スマート カードの戻り値」を参照してください。
例
次の例は、 アプリケーション プロトコル データ ユニット (APDU) の最初のパラメーター (P1) バイトを設定する方法を示しています。 この例では、pISCardCmd が ISCardCmd インターフェイスのインスタンスへの有効なポインターであると想定しています。
HRESULT hr;
// Set the P1 byte.
hr = pISCardCmd->put_P1(0x06);
if (FAILED(hr))
{
printf("Failed put_P1\n");
// Take other error handling action as needed.
}
必要条件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows XP [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
Windows Server 2003 [デスクトップ アプリのみ] |
| クライアント サポートの終了 |
Windows XP |
| サーバー サポートの終了 |
Windows Server 2003 |
| Header |
|
| タイプ ライブラリ |
|
| [DLL] |
|
| IID |
IID_ISCardCmdは D5778AE3-43DE-11D0-9171-00AA00C18068 として定義されています |
関連項目