StgMakeUniqueName 関数 (shlobj_core.h)

テンプレートからストリームまたはストレージ オブジェクトの一意の名前を作成します。

構文

HRESULT StgMakeUniqueName(
  [in]  IStorage *pstgParent,
  [in]  PCWSTR   pszFileSpec,
  [in]  DWORD    grfMode,
  [in]  REFIID   riid,
  [out] void     **ppv
);

パラメーター

[in] pstgParent

種類: IStorage*

IStorage オブジェクトへのポインター。

[in] pszFileSpec

種類: PCWSTR

ストリームまたはストレージ オブジェクトの名前の形式またはテンプレート。

[in] grfMode

型: DWORD

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

[in] riid

型: REFIID

ppv を介して取得するインターフェイスの IID への参照 (通常はIID_IStorageまたはIID_IStream)。

[out] ppv

型: void**

このメソッドから制御が戻るときに、 riid で要求されたインターフェイス ポインターが格納されます。 これは通常、 IStorage または IStream です。

戻り値

型: HRESULT

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

注釈

riid パラメーターと ppv パラメーターをパッケージ化するには、Objbase.h で定義されているIID_PPV_ARGS マクロを使用することをお勧めします。 このマクロは 、ppv の値によって指されるインターフェイスに基づいて正しい IID を提供するため、コーディング エラーが発生する可能性がなくなります。

要件