Fungsi SHValidateUNC (shlobj_core.h)

Artikel
03/02/2024

[SHValidateUNC tersedia untuk digunakan dalam sistem operasi yang ditentukan di bagian Persyaratan. Ini mungkin diubah atau tidak tersedia dalam versi berikutnya.]

Memvalidasi jalur Universal Naming Convention (UNC) dengan memanggil WNetAddConnection3. Fungsi ini memungkinkan pengguna untuk mengetik aplikasi UNC akses jaringan jarak jauh (RNA) atau nama dokumen dari kotak dialog Jalankan pada menu Mulai .

Sintaks

BOOL SHValidateUNC(
  [in, optional] HWND  hwndOwner,
  [in, out]      PWSTR pszFile,
                 UINT  fConnect
);

Parameter

[in, optional] hwndOwner

Jenis: HWND

Handel jendela induk, digunakan untuk menampilkan UI. Jika ini tidak diperlukan, nilai ini dapat diatur ke NULL.

[in, out] pszFile

Jenis: PWSTR

Penunjuk ke string Unicode yang dihentikan null yang menentukan jalur UNC untuk divalidasi. Catatan: String ini tidak boleh berupa string konstanta.

fConnect

Jenis: UINT

Satu atau beberapa nilai berikut ini.

VALIDATEUNC_CONNECT (0x0001)

Menyambungkan huruf kandar. Ketika bendera ini diatur, nilai dalam pszFile diubah ke drive lokal tempat UNC dipetakan pada komputer lokal.

VALIDATEUNC_NOUI (0x0002)

Pada kegagalan atau keberhasilan, tidak menampilkan UI.

VALIDATEUNC_PRINT (0x0004)

Validasi sebagai berbagi cetak daripada berbagi disk.

VALIDATEUNC_PERSIST (0x0008)

Windows Vista dan yang lebih baru. Koneksi harus dibuat persisten.

VALIDATEUNC_VALID

Nilai masker yang digunakan untuk memverifikasi bahwa bendera yang diteruskan ke SHValidateUNC valid.

Nilai kembali

Jenis: BOOL

Mengembalikan TRUE jika jalur UNC ada; FALSE jika jalur UNC tidak ada atau jika beberapa kegagalan lain terjadi.

Persyaratan

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

Bagikan melalui