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 エラー コードを返します。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | shlobj_core.h |
Library | Shell32.lib |
[DLL] | Shell32.dll (バージョン 6.0 以降) |