Metode IItemNameLimits::GetValidCharacters (shobjidl_core.h)

Artikel
08/26/2023

Memuat string yang berisi masing-masing karakter yang valid atau tidak valid di namespace layanan tempat string dipanggil.

Sintaks

HRESULT GetValidCharacters(
  [out] LPWSTR *ppwszValidChars,
  [out] LPWSTR *ppwszInvalidChars
);

Parameter

[out] ppwszValidChars

Jenis: LPWSTR*

Penunjuk ke string yang berisi semua karakter yang valid di namespace. Jika namespace menyediakan karakter yang tidak valid dalam ppwszInvalidChars, maka nilai ini mengembalikan NULL. Lihat Keterangan untuk detail selengkapnya.

[out] ppwszInvalidChars

Jenis: LPWSTR*

Penunjuk ke string yang berisi semua karakter yang tidak valid di namespace.

Nilai kembali

Jenis: HRESULT

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

Keterangan

Sebagai contoh, sistem file standar mengembalikan string "/:*?"<>|" dalam ppwszInvalidChars dan NULL di ppwszValidChars.

Kedua parameter tidak dapat mengembalikan nilai non-NULL, sehingga ppwszValidChars diberi nilai NULL karena nilai non-NULL

dalam ppwszInvalidChars. Diasumsikan bahwa ketika ada karakter yang tidak valid yang ditentukan, yang lainnya valid. Hanya ketika ppwszInvalidChars adalah NULL melakukan ppwszValidChars berisi daftar semua karakter yang valid.

Jika metode mengembalikan kode keberhasilan, string yang dialokasikan harus dibebaskan menggunakan CoTaskMemFree.

Persyaratan


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

Bagikan melalui