Función PathCchRenameExtension (pathcch.h)

Reemplaza la extensión de un nombre de archivo al final de una cadena de ruta de acceso por una nueva extensión. Si la cadena de ruta de acceso no termina con una extensión, se agrega la nueva extensión.

Esta función difiere de PathRenameExtension en que acepta rutas de acceso con prefijos "\", "\?" y "\?\UNC".

Nota Esta función se debe usar en lugar de PathRenameExtension para evitar la posibilidad de que se supere un búfer.

Sintaxis

WINPATHCCHAPI HRESULT PathCchRenameExtension(
  [in, out] PWSTR  pszPath,
  [in]      size_t cchPath,
  [in]      PCWSTR pszExt
);

Parámetros

[in, out] pszPath

Puntero a la cadena de ruta de acceso. Cuando esta función devuelve correctamente, este valor apunta a la misma cadena, pero con el nombre o la extensión agregada.

[in] cchPath

Tamaño del búfer al que apunta pszPath, en caracteres.

[in] pszExt

Puntero a la nueva cadena de extensión. El carácter "." inicial es opcional. En el caso de una cadena vacía (""), se quita cualquier extensión existente en la cadena de ruta de acceso.

Valor devuelto

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

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