SHPropStgCreate 関数 (shlobj_core.h)

[この機能は、Windows XP Service Pack 2 (SP2) と Windows Server 2003 を通じて使用できます。 それ以降のバージョンの Windows では、変更または使用できない可能性があります。

要求されたプロパティ セット操作のコード ページ取得または割り当ての適切な処理を保証します。

構文

SHSTDAPI SHPropStgCreate(
  [in]            IPropertySetStorage *psstg,
  [in]            REFFMTID            fmtid,
  [in, optional]  const CLSID         *pclsid,
                  DWORD               grfFlags,
                  DWORD               grfMode,
                  DWORD               dwDisposition,
  [out]           IPropertyStorage    **ppstg,
  [out, optional] UINT                *puCodePage
);

パラメーター

[in] psstg

種類: IPropertySetStorage*

IPropertySetStorage インターフェイスへのポインター。

[in] fmtid

型: REFFMTID

開くプロパティ セット ID。 このパラメーターの値には、 定義済みのプロパティ セット形式識別子 または登録する他の FMTID で定義されているもののいずれかを指定できます。

[in, optional] pclsid

型: const CLSID*

セットに関連付けられている CLSID へのポインター。 このパラメーターは、NULL でもかまいません。

grfFlags

型: DWORD

プロパティ セットの作成方法と開き方を決定する PROPSETFLAG 列挙体の 1 つ以上のメンバー。 ANSI バイトを含むすべてのセットは、PROPSETFLAG_ANSIで作成する必要があります。それ以外の場合はPROPSETFLAG_DEFAULT。

grfMode

型: DWORD

オブジェクトの作成と削除の条件と、オブジェクトのアクセス モードを示す STGM 列挙体のフラグ。 STGM_DIRECTを含む必要があります |STGM_SHARE_EXCLUSIVE。

dwDisposition

型: DWORD

Fileapi.h で定義されている次のいずれかの値。

CREATE_NEW (1)

まだ存在しない場合は、新しいセットを作成します。

CREATE_ALWAYS (2)

常に新しいセットを作成し、既存のセットを上書きします。

OPEN_EXISTING (3)

既存のセットを開きます。

OPEN_ALWAYS (4)

[out] ppstg

種類: IPropertyStorage**

このメソッドが返されるときに、 には IPropertyStorage インターフェイス ポインターが含まれます。

[out, optional] puCodePage

型: UINT*

このメソッドから制御が戻るときに、セットのコード ページ ID のアドレスが格納されます。

戻り値

型: HRESULT

この関数が成功すると、 S_OKが返されます。 そうでない場合は、HRESULT エラー コードを返します。

要件