ISCardISO7816::UpdateBinary メソッド

  • [アーティクル]

[ UpdateBinary メソッドは、[要件] セクションで指定されたオペレーティング システムで使用できます。 Windows Server 2003 Service Pack 1 (SP1) 以降、Windows Vista、Windows Server 2008、および以降のバージョンのオペレーティング システムでは使用できません。 スマート カード モジュールも同様の機能を提供します。

UpdateBinary メソッドは、基本ファイルに存在するビットを APDU コマンドで指定されたビットで更新するアプリケーション プロトコル データ ユニット (APDU) コマンドを構築します。

構文

HRESULT UpdateBinary(
  [in]      BYTE         byP1,
  [in]      BYTE         byP2,
  [in]      LPBYTEBUFFER pData,
  [in, out] LPSCARDCMD   *ppCmd
);

パラメーター

byP1 [in]

バイナリの先頭からバイナリへの書き込み (更新) 位置へのオフセット。 P1 の b8=1、P1 の b7 と b6 がゼロ (RFU ビット) に設定されている場合、P1 の b5 から b1 は短い EF 識別子であり、P2 はファイルの先頭からデータ単位で更新される最初のバイトのオフセットです。 P1 で b8=0 の場合、P1 ||P2 は、ファイルの先頭からデータ単位で更新される最初のバイトのオフセットです。

byP2 [in]

バイナリの先頭からバイナリへの書き込み (更新) 位置へのオフセット。 P1 の b8=1、P1 の b7 と b6 がゼロ (RFU ビット) に設定されている場合、P1 の b5 から b1 は短い EF 識別子であり、P2 はファイルの先頭からデータ単位で更新される最初のバイトのオフセットです。 P1 で b8=0 の場合、P1 ||P2 は、ファイルの先頭からデータ単位で更新される最初のバイトのオフセットです。

pData [in]

更新するデータ単位の文字列へのポインター。

ppCmd [in, out]

入力時に、 ISCardCmd インターフェイス オブジェクトまたは NULL へのポインター。

戻り時には、この操作によって作成された APDU コマンドが入力されます。 ppCmd が NULL に設定されている場合、スマート カードISCardCmd オブジェクトが内部的に作成され、ppCmd ポインターを使用して返されます。

戻り値

メソッドは、次のいずれかの値を返します。

リターン コード 説明
S_OK
 操作は正常に完了しました。
E_INVALIDARG
 無効なパラメーター。
E_POINTER
 不適切なポインターが渡されました。
E_OUTOFMEMORY
 メモリが不足しています。

 

解説

カプセル化されたコマンドは、スマート カードのセキュリティ状態が、処理される基本ファイルのセキュリティ属性を満たしている場合にのみ実行できます。

コマンドに有効な短い基本識別子が含まれている場合、ファイルは現在の基本ファイルとして設定されます。

透明構造のない基本ファイルは消去できません。 カプセル化されたコマンドは、透過的な構造を持たない基本ファイルに適用されると中止されます。

このインターフェイスによって提供されるすべてのメソッドの一覧については、「 ISCardISO7816」を参照してください。

上記の COM エラー コードに加えて、要求を完了するためにスマート カード関数が呼び出された場合、このインターフェイスはスマート カード エラー コードを返す場合があります。 詳細については、「 スマート カードの戻り値」を参照してください。

要件

要件 値
サポートされている最小のクライアント
 Windows XP [デスクトップ アプリのみ]
サポートされている最小のサーバー
 Windows Server 2003 [デスクトップ アプリのみ]
クライアント サポートの終了
 Windows XP
サーバー サポートの終了
 Windows Server 2003
ヘッダー
Scardssp.h
タイプ ライブラリ
Scardsrv.tlb
[DLL]
Scardssp.dll
IID
 IID_ISCardISO7816は 53B6AA68-3F56-11D0-916B-00AA00C18068 として定義されています

関連項目

EraseBinary

ISCardISO7816

ReadBinary

WriteBinary