Método IItemNameLimits::GetValidCharacters (shobjidl_core.h)

Carrega uma cadeia de caracteres que contém cada um dos caracteres que são válidos ou inválidos no namespace no qual ele é chamado.

Sintaxe

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

Parâmetros

[out] ppwszValidChars

Tipo: LPWSTR*

Um ponteiro para uma cadeia de caracteres que contém todos os caracteres válidos no namespace. Se o namespace fornecer caracteres inválidos em ppwszInvalidChars, esse valor retornará NULL. Consulte Comentários para obter mais detalhes.

[out] ppwszInvalidChars

Tipo: LPWSTR*

Um ponteiro para uma cadeia de caracteres que contém todos os caracteres inválidos no namespace.

Valor retornado

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Por exemplo, o sistema de arquivos padrão retorna a cadeia de caracteres "/:*?"<>|" em ppwszInvalidChars e NULL em ppwszValidChars.

Ambos os parâmetros não podem retornar valores não NULL, portanto ppwszValidChars recebe um valor NULL devido ao valor não NULL

em ppwszInvalidChars. Supõe-se que, quando houver caracteres inválidos especificados, todo o resto seja válido. Somente quando ppwszInvalidChars é NULL , ppwszValidChars contém uma lista de todos os caracteres válidos.

Se o método retornar um código de êxito, a cadeia de caracteres alocada deverá ser liberada usando CoTaskMemFree.

Requisitos