Función PathAllocCanonicalize (pathcch.h)
Convierte una cadena de ruta de acceso en un formato canónico.
Esta función difiere de PathCchCanonicalize y PathCchCanonicalizeEx en que devuelve el resultado en el montón. Esto significa que el autor de la llamada no tiene que declarar el tamaño de la cadena devuelta y reduce el uso de la pila.
Esta función difiere de PathCanonicalize en que acepta rutas de acceso con prefijos "\", "\?" y "\?\UNC".
Sintaxis
WINPATHCCHAPI HRESULT PathAllocCanonicalize(
[in] PCWSTR pszPathIn,
[in] ULONG dwFlags,
[out] PWSTR *ppszPathOut
);
Parámetros
[in] pszPathIn
Puntero a un búfer que contiene la cadena original. Este valor no puede ser NULL.
[in] dwFlags
Una o varias de las marcas siguientes:
[out] ppszPathOut
La dirección de un puntero a un búfer que, cuando esta función vuelve correctamente, recibe la cadena de ruta de acceso canónica. Es responsabilidad del autor de la llamada liberar este recurso, cuando ya no es necesario, mediante una llamada a la función LocalFree . Este valor no puede ser NULL.
Valor devuelto
Si esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.
Comentarios
Esta función admite estas formas de ruta de acceso alternativas:
- \\?\
- \\?\\UNC\
- \\?\Volume{guid}\
Esta función no convierte barras diagonales (/) en barras diagonales inversas (\). Con la entrada que no es de confianza, esta función no se puede usar para convertir rutas de acceso en un formulario que se pueda comparar con otras rutas de acceso para la subruta o la identidad. Los autores de llamadas que necesitan esa capacidad deben convertir hacia delante a barras diagonales inversas antes de usar esta función.
Requisitos
Requisito | Value |
---|---|
Cliente mínimo compatible | Windows 8 [aplicaciones de escritorio | Aplicaciones para UWP] |
Servidor mínimo compatible | Windows Server 2012 [aplicaciones de escritorio | Aplicaciones para UWP] |
Plataforma de destino | Windows |
Encabezado | pathcch.h |
Library | Pathcch.lib |
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: a lo largo de 2024, eliminaremos gradualmente los problemas de GitHub como mecanismo de comentarios para el contenido y lo reemplazaremos por un nuevo sistema de comentarios. Para obtener más información, consulte:Enviar y ver comentarios de