ISCardISO7816::AppendRecord メソッド
[ AppendRecord メソッドは、[要件] セクションで指定したオペレーティング システムで使用できます。 Windows Server 2003 Service Pack 1 (SP1) 以降、Windows Vista、Windows Server 2008、および以降のバージョンのオペレーティング システムでは使用できません。 スマート カード モジュールも同様の機能を提供します。
AppendRecord メソッドは、線形構造化基本ファイル (EF) の末尾にレコードを追加するか、循環構造の基本ファイルにレコード番号 1 を書き込むアプリケーション プロトコル データ ユニット (APDU) コマンドを構築します。
構文
HRESULT AppendRecord(
[in] BYTE byRefCtrl,
[in] LPBYTEBUFFER pData,
[in, out] LPSCARDCMD *ppCmd
);
パラメーター
-
byRefCtrl [in]
-
追加する基本ファイルを識別します。
値 説明 - 現在の EF
ビット位置: 000000000 - 短い EF ID
ビット位置: xxxxx000 - Reserved
ビット位置: xxxxxxxx -
pData [in]
-
ファイルに追加するデータへのポインター。
値 説明 - テネシー
1 バイト - Ln
1 バイトまたは 3 バイト - data
Ln バイト数 -
ppCmd [in, out]
-
入力時に、 ISCardCmd インターフェイス オブジェクトまたは NULL へのポインター。
戻り時には、この操作によって作成された APDU コマンドが入力されます。 ppCmd が NULL に設定されている場合、スマート カードISCardCmd オブジェクトが内部的に作成され、ppCmd ポインターを使用して返されます。
戻り値
メソッドは、次のいずれかの値を返します。
| リターン コード | 説明 |
|---|---|
|
操作は正常に完了しました。 |
|
無効なパラメーター。 |
|
不適切なポインターが渡されました。 |
|
メモリが不足しています。 |
解説
カプセル化されたコマンドは、スマート カードのセキュリティ状態が、読み取られた基本ファイルのセキュリティ属性を満たす場合にのみ実行できます。
このコマンドの実行時に別の基本ファイルが選択されている場合は、現在選択されているファイルを識別せずに処理される場合があります。
レコード構造のない基本ファイルは読み取れません。 カプセル化されたコマンドは、レコード構造のない基本ファイルに適用されると中止されます。
このインターフェイスによって提供されるすべてのメソッドの一覧については、「 ISCardISO7816」を参照してください。
上記の COM エラー コードに加えて、要求を完了するためにスマート カード関数が呼び出された場合、このインターフェイスはスマート カード エラー コードを返す場合があります。 詳細については、「 スマート カードの戻り値」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows XP [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
Windows Server 2003 [デスクトップ アプリのみ] |
| クライアント サポートの終了 |
Windows XP |
| サーバー サポートの終了 |
Windows Server 2003 |
| ヘッダー |
|
| タイプ ライブラリ |
|
| [DLL] |
|
| IID |
IID_ISCardISO7816は 53B6AA68-3F56-11D0-916B-00AA00C18068 として定義されています |
関連項目