IItemNameLimits::GetValidCharacters, méthode (shobjidl_core.h)

Charge une chaîne qui contient chacun des caractères valides ou non valides dans l’espace de noms sous lequel elle est appelée.

Syntaxe

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

Paramètres

[out] ppwszValidChars

Type : LPWSTR*

Pointeur vers une chaîne qui contient tous les caractères valides dans l’espace de noms. Si l’espace de noms fournit des caractères non valides dans ppwszInvalidChars, cette valeur retourne NULL. Pour plus d’informations, consultez Remarques.

[out] ppwszInvalidChars

Type : LPWSTR*

Pointeur vers une chaîne qui contient tous les caractères non valides dans l’espace de noms.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Par exemple, le système de fichiers standard retourne la chaîne « /:*?|<> » dans ppwszInvalidChars et NULL dans ppwszValidChars.

Les deux paramètres ne peuvent pas renvoyer des valeurs non NULL. Une valeur null est donc attribuée à ppwszValidChars en raison de la valeur non NULL

dans ppwszInvalidChars. Il est supposé que lorsque des caractères non valides spécifiés sont spécifiés, tout le reste est valide. Ce n’est que lorsque ppwszInvalidChars a la valeur NULL que ppwszValidChars contient une liste de tous les caractères valides.

Si la méthode retourne un code de réussite, la chaîne allouée doit être libérée à l’aide de CoTaskMemFree.

Configuration requise