Función PathCchRemoveExtension (pathcch.h)

Artículo
03/01/2024

Quita la extensión de nombre de archivo de una ruta de acceso, si hay una.

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

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

Sintaxis

WINPATHCCHAPI HRESULT PathCchRemoveExtension(
  [in, out] PWSTR  pszPath,
  [in]      size_t cchPath
);

Parámetros

[in, out] pszPath

Puntero a la cadena de ruta de acceso. Cuando esta función vuelve correctamente, la cadena contiene la ruta de acceso con cualquier extensión quitada. Si no se encontró ninguna extensión, la cadena no cambia.

[in] cchPath

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

Valor devuelto

Esta función devuelve S_OK si la función se realizó correctamente, S_FALSE si no se encontró ninguna extensión o un código de error de lo contrario.

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