IPersistPropertyBag::Save メソッド (ocidl.h)

  • [アーティクル]

指定したプロパティ バッグにプロパティを保存し、必要に応じてオブジェクトの ダーティ フラグをクリアするようにオブジェクトに指示します。

構文

HRESULT Save(
  IPropertyBag *pPropBag,
  BOOL         fClearDirty,
  BOOL         fSaveAllProperties
);

パラメーター

pPropBag

オブジェクトがプロパティを書き込むことができる呼び出し元のプロパティ バッグのアドレス。 これを NULL にすることはできません。

fClearDirty

"保存" 操作が完了したときに、オブジェクトがそのダーティ フラグをクリアする必要があるかどうかを示すフラグ。 TRUE はフラグをクリアし、FALSE はフラグを影響を受けずに残すことを意味します。 FALSE は、呼び出し元が "名前を付けてコピーを保存" 操作を実行するときに使用されます。

fSaveAllProperties

オブジェクトがすべてのプロパティ (TRUE) を保存するか、既定値 (FALSE) から変更されたプロパティのみを保存するかを示すフラグ。

注釈

呼び出し元は、オブジェクトにすべてのプロパティを保存するか、変更されたプロパティのみを保存することを要求できます。

E_NOTIMPLは有効なリターン コードではありません。このインターフェイスを実装するオブジェクトはインターフェイスの機能全体をサポートする必要があるためです。

要件

要件 値
サポートされている最小のクライアント Windows 10 ビルド 20348
サポートされている最小のサーバー Windows 10 ビルド 20348
Header ocidl.h