IStorage::CreateStorage メソッド (objidl.h)

CreateStorage メソッドは、指定したアクセス モードで指定した名前を持つ、このストレージ オブジェクト内に入れ子になった新しいストレージ オブジェクトを作成して開きます。

構文

HRESULT CreateStorage(
  [in]  const OLECHAR *pwcsName,
  [in]  DWORD         grfMode,
  [in]  DWORD         reserved1,
  [in]  DWORD         reserved2,
  [out] IStorage      **ppstg
);

パラメーター

[in] pwcsName

新しく作成されたストレージ オブジェクトの名前を含むワイド文字の null で終わる Unicode 文字列へのポインター。 名前は、後でストレージ オブジェクトを再度開くために使用できます。 名前の長さは 31 文字を超えてはなりません。文字列終端記号は含まれません。 ストリーム/ストレージ名の最初の文字として機能する 000 から 01f の文字は、OLE で使用するために予約されています。 これは複合ファイルの制限であり、構造化ストレージの制限ではありません。

[in] grfMode

新しく作成されたストレージ オブジェクトを開くときに使用するアクセス モードを指定する 値です。 使用可能な値の詳細と説明については、「 STGM 定数」を参照してください。

[in] reserved1

今後使用するために予約されています。0 にする必要があります。

[in] reserved2

今後使用するために予約されています。0 にする必要があります。

[out] ppstg

成功した場合は、新しく作成されたストレージ オブジェクトへの IStorage ポインターの場所へのポインター。 エラーが発生した場合、このパラメーターは NULL に設定されます。

戻り値

このメソッドは、これらの値のいずれかを返すことができます。

注釈

pwcsName パラメーターで指定された名前のストレージが親ストレージ オブジェクト内に既に存在し、grfMode パラメーターに STGM_CREATE フラグが含まれている場合、既存のストレージは新しいストレージに置き換えられます。 grfMode パラメーターに STGM_CONVERT フラグが含まれている場合、既存の要素は CONTENTS という名前のストリーム オブジェクトに変換され、CONTENTS ストリーム オブジェクトを含む新しいストレージ オブジェクトが作成されます。 古い要素の破棄と新しいストレージ オブジェクトの作成は、どちらも親ストレージ オブジェクトのトランザクション モードの対象になります。 STGM_CREATEも使用している場合は、STGM_CONVERTを使用できないことに注意してください。

IStorage::CreateStorage メソッドの COM 提供の複合ファイル実装では、次の動作はサポートされていません。

• 非ルート ストレージのSTGM_PRIORITY フラグ。
• 同じ親ストレージから同じストレージ オブジェクトを複数回開く。 STGM_SHARE_EXCLUSIVE フラグを指定する必要があります。
• STGM_DELETEONRELEASE フラグ。 このフラグを指定すると、関数は STG_E_INVALIDFLAGを返します。

要件

こちらもご覧ください

IStorage - 複合ファイルの実装

IStorage::OpenStorage