Fungsi PathProcessCommand (shlobj.h)

Artikel
03/13/2024

Dihentikan. Memproses string yang berisi baris perintah dan menghasilkan string yang dikutip yang sesuai, dengan argumen yang dilampirkan jika diperlukan.

Sintaks

LONG PathProcessCommand(
  [in]  PCWSTR pszSrc,
  [out] PWSTR  pszDest,
        int    cchDest,
        DWORD  dwFlags
);

Parameter

[in] pszSrc

Jenis: PCWSTR

Penunjuk ke string yang dihentikan null yang berisi baris perintah untuk diproses.

[out] pszDest

Jenis: PWSTR

Penunjuk ke buffer yang menerima string Unicode yang dihentikan null dengan tanda kutip yang sesuai. Untuk menentukan seberapa besar buffer ini, atur parameter ini ke NULL. Fungsi mengembalikan ukuran buffer yang diperlukan.

cchDest

Jenis: int

Jumlah maksimum karakter yang dapat dimasukkan ke dalam pszDest, tidak termasuk karakter null yang mengakhiri. Jika nilai ini terlalu kecil, fungsi akan gagal.

dwFlags

Jenis: DWORD

Bendera yang mengontrol prosedur. Satu atau beberapa nilai berikut ini:

PPCF_ADDQUOTES (0x00000001)

Tambahkan tanda kutip jika jalur memerlukannya.

PPCF_ADDARGUMENTS (0x00000003)

Tambahkan argumen berikutnya ke string output. Nilai ini mencakup PPCF_ADDQUOTES.

PPCF_NODIRECTORIES (0x00000010)

Jangan cocokkan string input dengan folder, hanya terhadap objek file.

PPCF_FORCEQUALIFY (0x00000040)

Memenuhi syarat bahkan nama file non-relatif.

PPCF_LONGESTPOSSIBLE (0x00000080)

Selalu pilih nama terlama yang dapat dieksekusi.

Mengembalikan nilai

Jenis: LONG

Mengembalikan nilai positif jika berhasil. Jika lpDest diatur ke NULL, fungsi mengembalikan ukuran buffer yang diperlukan dalam karakter, termasuk karakter null yang mengakhiri. Jika panggilan gagal, fungsi mengembalikan nilai negatif.

Keterangan

Catatan Fungsi ini tersedia melalui Windows XP Service Pack 2 (SP2) dan Windows Server 2003. Ini tidak didukung di Windows Vista dan versi Windows yang lebih baru.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	shlobj.h
Pustaka	Shell32.lib
DLL	Shell32.dll (versi 5.0 atau yang lebih baru)

Bagikan melalui