ISCardISO7816::EraseBinary メソッド
[ EraseBinary メソッドは、 [要件] セクションで指定されたオペレーティング システムで使用できます。 Windows Server 2003 Service Pack 1 (SP1) 以降、Windows Vista、Windows Server 2008、およびそれ以降のバージョンのオペレーティング システムでは使用できません。 スマート カード モジュールも同様の機能を提供します。
EraseBinary メソッドは、基本ファイルのコンテンツの一部を、指定されたオフセットから論理的に消去された状態に順番に設定するアプリケーション プロトコル データ ユニット (APDU) コマンドを構築します。
構文
HRESULT EraseBinary(
[in] BYTE byP1,
[in] BYTE byP2,
[in] LPBYTEBUFFER pData,
[in, out] LPSCARDCMD *ppCmd
);
パラメーター
-
byP1 [in]
-
RFU の位置。
P1 の b8=1、P1 の b7 と b6 がゼロ (RFU ビット) に設定されている場合、P1 の b5 から b1 は短い EF 識別子であり、P2 はファイルの先頭から消去される最初のバイトのオフセット (データ単位) です。
P1 で b8=0 の場合、P1 ||P2 は、ファイルの先頭から消去される最初のバイトのオフセットです (データ単位)。
データ フィールドが存在する場合は、消去されない最初のデータユニットのオフセットを指定します。 このオフセットは、P1-P2 でコード化されたオフセットよりも大きくする必要があります。 データ フィールドが空の場合、コマンドはファイルの末尾まで消去されます。
-
byP2 [in]
-
RFU の位置。
P1 の b8=1、P1 の b7 と b6 がゼロ (RFU ビット) に設定されている場合、P1 の b5 から b1 は短い EF 識別子であり、P2 はファイルの先頭から消去される最初のバイトのオフセット (データ単位) です。
P1 で b8=0 の場合、P1 ||P2 は、ファイルの先頭から消去される最初のバイトのオフセットです (データ単位)。
データ フィールドが存在する場合は、消去されない最初のデータユニットのオフセットを指定します。 このオフセットは、P1-P2 でコード化されたオフセットよりも大きくする必要があります。 データ フィールドが空の場合、コマンドはファイルの末尾まで消去されます。
-
pData [in]
-
消去範囲を指定するデータへのポインター。 このパラメーターは NULL である可能性があります。
-
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 として定義されています |
関連項目