IPersistStream::GetSizeMax メソッド (objidl.h)
オブジェクトの保存に必要なストリームのサイズを取得します。
構文
HRESULT GetSizeMax(
[out] ULARGE_INTEGER *pcbSize
);
パラメーター
[out] pcbSize
このオブジェクトを保存するために必要なストリームのサイズ (バイト単位)。
戻り値
このメソッドは、サイズが正常に取得されたことを示すS_OKを返します。
注釈
このメソッドは、オブジェクトを保存するために必要なサイズを返します。 IPersistStream::Save メソッドを呼び出す前に、このメソッドを呼び出してサイズを決定し、必要なバッファーを設定できます。
実装者へのメモ
GetSizeMax の実装では、呼び出し元が IPersistStream::Save メソッドを非拡張ストリームで呼び出す可能性があるため、必要なサイズの控えめな見積もりを返す必要があります。URL モニカーに関する注意事項
このメソッドは、 後続の IPersistStream::Save の呼び出しに必要なストリーム内の最大バイト数を取得します。 この値は sizeof(ULONG)==4 plus sizeof(WCHAR)*n です。n は、NULL 終端記号を含む完全または部分的な URL 文字列の長さです。要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | objidl.h |