Función PathAllocCanonicalize (pathcch.h)

Convierte una cadena de ruta de acceso en una forma canónica.

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 se puede 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, llamando a la función LocalFree. Este valor no se puede null.

Valor devuelto

Si esta función se ejecuta correctamente, devuelve S_OK. De lo contrario, devuelve un hrESULT código de error.

Observaciones

Esta función admite estos formularios alternativos de ruta de acceso:

• \\?\
• \\?\\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