共用方式為

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 錯誤碼。

備註

建議您使用 Objbase.h 中定義的 IID_PPV_ARGS 宏來封裝 riid 和 ppv 參數。 這個宏會根據 ppv 中值所指向的介面提供正確的 IID，這可消除編碼錯誤的可能性。

規格需求

需求 值
最低支援的用戶端 Windows 7 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 R2 [僅限桌面應用程式]
目標平台 Windows
標頭 shlobj_core.h (包含 Shlobj.h)
程式庫 Shell32.lib
Dll Shell32.dll (6.1 版或更新版本)