Función PathCchFindExtension (pathcch.h)

  • Artículo

Busca una ruta de acceso para buscar su extensión de nombre de archivo, como ".exe" o ".ini". Esta función no busca una extensión específica; busca la presencia de cualquier extensión.

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

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

Sintaxis

WINPATHCCHAPI HRESULT PathCchFindExtension(
  [in]  PCWSTR pszPath,
  [in]  size_t cchPath,
  [out] PCWSTR *ppszExt
);

Parámetros

[in] pszPath

Puntero a la ruta de acceso que se va a buscar.

[in] cchPath

Tamaño del búfer al que apunta pszPath en caracteres, incluido el terminador null.

[out] ppszExt

La dirección de un puntero que, cuando esta función devuelve correctamente, apunta al carácter "." que precede a la extensión dentro de pszPath. Si no se encuentra ninguna extensión, apunta al carácter nulo de terminación de la cadena.

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