IMarshal::ReleaseMarshalData メソッド (objidlbase.h)

[アーティクル]
02/29/2024

マーシャリングされたデータパケットを破棄します。

構文

HRESULT ReleaseMarshalData(
  [in] IStream *pStm
);

パラメーター

[in] pStm

破棄されるデータパケットを含むストリームへのポインター。

戻り値

このメソッドは、 IStream インターフェイスのストリームアクセスエラーと同様に、S_OKおよびE_FAIL標準の戻り値を返すことができます。

注釈

オブジェクトのマーシャリングされたデータパケットがクライアントプロセス空間でマーシャリングされず、パケットが不要になった場合、クライアントはプロキシの IMarshal 実装で ReleaseMarshalData を呼び出して、データパケットを破棄するようにオブジェクトに指示します。呼び出しは、CoReleaseMarshalData 関数内で行われます。データパケットはオブジェクトの追加の参照として機能し、データを解放することは、Release を呼び出してインターフェイスポインターを解放するようなものです。

マーシャリングされたデータパケットが何らかの形でクライアントプロセスに到着しない場合、または ReleaseMarshalData がプロキシで正常に再作成されない場合、COM はオブジェクト自体でこのメソッドを呼び出すことができます。

呼び出し元へのメモ

このメソッドを自分で呼び出す機会がない場合は、めったにありません。 IMarshal も実装しているクラスオブジェクトのクラスファクトリに IMarshal を実装すると、例外が発生する可能性があります。この場合、オブジェクトを複数のクライアントによって取得できるテーブルにマーシャリングする場合は、マーシャリング解除ルーチンの一部として ReleaseMarshalData を呼び出して、各プロキシのデータパケットを解放できます。

実装者へのメモ

実装にマーシャリングされたデータパケットに関する状態情報が格納されている場合は、このメソッドを使用して 、pStm で表されるデータパケットに関連付けられている状態情報を解放できます。実装では、データの最後のバイトを超えてストリーム内にシークポインターを配置する必要もあります。

要件

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリ \|UWP アプリ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリ \|UWP アプリ]
対象プラットフォーム	Windows
ヘッダー	objidlbase.h (ObjIdl.h を含む)

こちらもご覧ください

CoReleaseMarshalData

IMarshal