ISCardTypeConv::GetAtIStreamMemory メソッド

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

GetAtIStreamMemory メソッドは、IStream COM インターフェイスによって管理される HGLOBAL メモリ ブロックへのバイト ポインターを取得します。

これは、メモリ ブロックの sizeof 値をバイト単位で取得し、 IStream インターフェイスを使用してバイトを一時バイト配列に読み取ることなく 、IStream の下のメモリで取得する方法です。

構文

HRESULT GetAtIStreamMemory(
  [in]  LPSTREAM    pStrm,
  [out] LPBYTEARRAY *ppMem
);

パラメーター

pStrm [in]

HGLOBAL メモリ ブロックを管理する IStream COM インターフェイスへのポインター。

ppMem [out]

HGLOBAL メモリ ブロックの最初のバイトへのポインター (成功した場合)。それ以外の場合、操作が失敗した場合は NULL 。

戻り値

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

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

 

解説

取得した ppMem ポインターごとに、IStream 参照カウントがインクリメントされます。

必要条件

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

スマート カードの戻り値