IPersistStream::GetSizeMax メソッド (objidl.h)

オブジェクトの保存に必要なストリームのサイズを取得します。

構文

HRESULT GetSizeMax(
  [out] ULARGE_INTEGER *pcbSize
);

[out] pcbSize

このオブジェクトを保存するために必要なストリームのサイズ (バイト単位)。

このメソッドは、サイズが正常に取得されたことを示すS_OKを返します。

このメソッドは、オブジェクトを保存するために必要なサイズを返します。 IPersistStream::Save メソッドを呼び出す前に、このメソッドを呼び出してサイズを決定し、必要なバッファーを設定できます。

GetSizeMax の実装では、呼び出し元が IPersistStream::Save メソッドを非拡張ストリームで呼び出す可能性があるため、必要なサイズの控えめな見積もりを返す必要があります。

このメソッドは、後続の IPersistStream::Save の呼び出しに必要なストリーム内の最大バイト数を取得します。この値は sizeof(ULONG)==4 plus sizeof(WCHAR)*n です。n は、NULL 終端記号を含む完全または部分的な URL 文字列の長さです。

要件	値
サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	objidl.h