Compartir a través de

Función PathCchRemoveExtension (pathcch.h)

  • Artículo

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