ISCardISO7816::ReadBinary メソッド

[アーティクル]
06/13/2023

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

ReadBinary メソッドは、透過的に構造化された基本ファイルの内容のその部分を提供する応答メッセージを取得するアプリケーションプロトコルデータユニット (APDU) コマンドを構築します。

構文

HRESULT ReadBinary(
  [in]      BYTE       byP1,
  [in]      BYTE       byP2,
  [in]      LONG       lBytesToRead,
  [in, out] LPSCARDCMD *ppCmd
);

パラメーター

byP1 [in]

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

byP2 [in]

lBytesToRead [in]

透過的 EF から読み取るバイト数。

Le フィールドにゼロのみが含まれている場合は、短い長さの場合は 256、拡張長の場合は 65536 の制限内では、ファイルの末尾までのすべてのバイトを読み取る必要があります。

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 として定義されています

次の方法で共有

ISCardISO7816::ReadBinary メソッド

構文

パラメーター

戻り値

解説

要件

関連項目

フィードバック

その他のリソース