Fungsi SHCreateItemFromParsingName (shobjidl_core.h)

Artikel
08/26/2023

Membuat dan menginisialisasi objek item Shell dari nama penguraian.

Sintaks

SHSTDAPI SHCreateItemFromParsingName(
  [in]           PCWSTR   pszPath,
  [in, optional] IBindCtx *pbc,
  [in]           REFIID   riid,
  [out]          void     **ppv
);

Parameter

[in] pszPath

Jenis: PCWSTR

Penunjuk ke nama tampilan.

[in, optional] pbc

Jenis: IBindCtx*

Pilihan. Penunjuk ke konteks ikatan yang digunakan untuk meneruskan parameter sebagai input dan output ke fungsi penguraian. Parameter yang diteruskan ini sering kali khusus untuk sumber data dan di dokumentasikan oleh pemilik sumber data. Misalnya, sumber data sistem file menerima nama yang diurai (sebagai struktur WIN32_FIND_DATA ), menggunakan parameter konteks ikat STR_FILE_SYS_BIND_DATA .

STR_PARSE_PREFER_FOLDER_BROWSING dapat diteruskan untuk menunjukkan bahwa URL diurai menggunakan sumber data sistem file jika memungkinkan. Buat objek konteks ikatan menggunakan CreateBindCtx dan isi nilai menggunakan IBindCtx::RegisterObjectParam. Lihat Mengikat Kunci String Konteks untuk daftar lengkapnya. Lihat Sampel Penguraian Dengan Parameter untuk contoh penggunaan parameter ini.

Jika tidak ada data yang diteruskan ke atau diterima dari fungsi penguraian, nilai ini bisa NULL.

[in] riid

Jenis: REFIID

Referensi ke IID antarmuka untuk diambil melalui ppv, biasanya IID_IShellItem atau IID_IShellItem2.

[out] ppv

Jenis: batal**

Ketika metode ini berhasil dikembalikan, berisi pointer antarmuka yang diminta dalam riid. Ini biasanya IShellItem atau IShellItem2.

Menampilkan nilai

Jenis: HRESULT

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

Keterangan

Kami menyarankan agar Anda menggunakan makro IID_PPV_ARGS , yang ditentukan dalam Objbase.h, untuk mengemas parameter riid dan ppv . Makro ini menyediakan IID yang benar berdasarkan antarmuka yang ditunjukkan oleh nilai dalam ppv, yang menghilangkan kemungkinan kesalahan pengkodian dalam riid yang dapat menyebabkan hasil yang tidak terduga.

Persyaratan


Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	shobjidl_core.h (termasuk Shobjidl.h)
DLL	Shell32.dll

Bagikan melalui