ISCardTypeConv::CreateByteBuffer メソッド

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

CreateByteBuffer メソッドは、IStream (IByteBuffer) オブジェクトにマップされたバイトのユニバーサル バッファーを作成します。

作成されるバイト バッファーは、メモリ ブロックにマップされたストリームです。 バッファーにアクセスまたは管理するには、 IStream インターフェイスによって提供されるメソッドを使用します。 この配列実装に関する一意の機能は、 IStream::Release メソッドを呼び出すと、基になるメモリが解放されることです。

構文

HRESULT CreateByteBuffer(
  [in]  DWORD        dwAllocSize,
  [out] LPBYTEBUFFER *ppbyBuff
);

パラメーター

dwAllocSize [in]

配列に割り当てられるメモリのサイズ (バイト単位)。

ppbyBuff [out]

返される IStream オブジェクトへのポインター。

戻り値

可能な戻り値は次のとおりです。

リターン コード	説明
S_OK	メモリが正常に割り当てられた。
E_INVALIDARG	関数に渡される 1 つ以上のパラメーターに問題があります。
E_OUTOFMEMORY	要求を満たすのに十分な空きメモリがありません。

 

解説

割り当てられたメモリは移動可能です。 メモリを解放するには 、IStream::Release メソッドを使用します。

一般的な C/C++ バイト配列を作成するには、 CreateByteArray を呼び出します。

署名されていない文字 (バイト) の Automation SAFEARRAY を作成するには、 CreateSafeArray を呼び出します。

要件

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

関連項目

ISCardTypeConv

スマート カードの戻り値

CreateByteArray

CreateSafeArray