次の方法で共有


ISCardTypeConv::ConvertSafeArrayToByteBuffer メソッド

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

ConvertSafeArrayToByteBuffer メソッドは、SAFEARRAY として定義されたバイト配列をバイトの汎用バッファー (IStream オブジェクト) に変換します。

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

構文

HRESULT ConvertSafeArrayToByteBuffer(
  [in]  LPSAFEARRAY  pbyArray,
  [out] LPBYTEBUFFER *ppbyBuff
);

パラメーター

pbyArray [in]

変換する SAFEARRAY へのポインター。

ppbyBuff [out]

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

戻り値

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

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

 

解説

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

要件

要件
サポートされている最小のクライアント
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

スマート カードの戻り値