Compartir a través de

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

  • Artículo

Carga una cadena que contiene cada uno de los caracteres que son válidos o no válidos en el espacio de nombres en el que se llama.

Sintaxis

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

Parámetros

[out] ppwszValidChars

Tipo: LPWSTR*

Puntero a una cadena que contiene todos los caracteres válidos en el espacio de nombres. Si el espacio de nombres proporciona caracteres no válidos en ppwszInvalidChars, este valor devuelve NULL. Consulte Comentarios para obtener más detalles.

[out] ppwszInvalidChars

Tipo: LPWSTR*

Puntero a una cadena que contiene todos los caracteres no válidos en el espacio de nombres.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

Por ejemplo, el sistema de archivos estándar devuelve la cadena "/:*?"<>|". en ppwszInvalidChars y NULL en ppwszValidChars.

Ambos parámetros no pueden devolver valores no NULL , por lo que a ppwszValidChars se le asigna un valor NULL debido al valor distinto de NULL .

en ppwszInvalidChars. Se supone que cuando hay caracteres no válidos especificados, todo lo demás es válido. Solo cuando ppwszInvalidChars es NULL , ppwszValidChars contiene una lista de todos los caracteres válidos.

Si el método devuelve un código correcto, la cadena asignada debe liberarse mediante CoTaskMemFree.

Requisitos

   
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shobjidl_core.h (include Shobjidl.h)
Archivo DLL Shell32.dll