Metodo IItemNameLimits::GetValidCharacters (shobjidl_core.h)

Carica una stringa contenente ognuno dei caratteri validi o non validi nello spazio dei nomi in cui viene chiamato.

Sintassi

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

Parametri

[out] ppwszValidChars

Tipo: LPWSTR*

Puntatore a una stringa contenente tutti i caratteri validi nello spazio dei nomi. Se lo spazio dei nomi fornisce caratteri non validi in ppwszInvalidChars, questo valore restituisce NULL. Per altri dettagli, vedere Osservazioni.

[out] ppwszInvalidChars

Tipo: LPWSTR*

Puntatore a una stringa contenente tutti i caratteri non validi nello spazio dei nomi.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Ad esempio, il file system standard restituisce la stringa "/:*?"<>|" in ppwszInvalidChars e NULL in ppwszValidChars.

Entrambi i parametri non possono restituire valori non NULL, quindi ppwszValidChars viene assegnato un valore NULL a causa del valore non NULL

in ppwszInvalidChars. Si presuppone che, quando sono presenti caratteri non validi, tutto il resto è valido. Solo quando ppwszInvalidChars è NULL esegue ppwszValidChars contiene un elenco di tutti i caratteri validi.

Se il metodo restituisce un codice riuscito, la stringa allocata deve essere liberata usando CoTaskMemFree.

Requisiti