ISCardTypeConv::FreeIStreamMemoryPtr メソッド

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

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

構文

HRESULT FreeIStreamMemoryPtr(
  [in] LPSTREAM pStrm,
  [in] LPBYTE   pMem
);

パラメーター

pStrm [in]

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

pMem [in]

IStream インターフェイスによって管理されるメモリ ブロックへのポインター。

戻り値

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

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

 

解説

この関数は、 IStream インターフェイスによって管理される HGLOBAL メモリ ブロックを指すバイト ポインターを完全かつクリーンに解放します。 バイト ポインターは、 GetAtIStreamMemory の呼び出しによって取得されます。

要件

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

スマート カードの戻り値

GetAtIStreamMemory