Fungsi StgMakeUniqueName (shlobj_core.h)

Membuat nama unik untuk aliran atau objek penyimpanan dari templat.

Sintaks

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

Parameter

[in] pstgParent

Jenis: IStorage*

Penunjuk ke objek IStorage .

[in] pszFileSpec

Jenis: PCWSTR

Format atau templat untuk nama aliran atau objek penyimpanan.

[in] grfMode

Jenis: DWORD

Mode akses yang digunakan saat membuka aliran atau objek penyimpanan. Untuk informasi selengkapnya dan deskripsi nilai yang mungkin, lihat Konstanta STGM.

[in] riid

Jenis: REFIID

Referensi ke IID antarmuka untuk diambil melalui ppv, biasanya IID_IStorage atau IID_IStream.

[out] ppv

Jenis: void**

Ketika metode ini kembali, berisi pointer antarmuka yang diminta dalam riid. Ini biasanya IStorage atau IStream.

Nilai kembali

Jenis: HRESULT

Jika fungsi ini berhasil, fungsi akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Disarankan agar Anda menggunakan makro IID_PPV_ARGS , yang didefinisikan dalam Objbase.h, untuk mengemas parameter riid dan ppv . Makro ini menyediakan IID yang benar berdasarkan antarmuka yang diacu oleh nilai dalam ppv, yang menghilangkan kemungkinan kesalahan pengkodian.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform	Windows
Header	shlobj_core.h (termasuk Shlobj.h)
Pustaka	Shell32.lib
DLL	Shell32.dll (versi 6.1 atau yang lebih baru)