Compartir a través de

Función PathCommonPrefixA (shlwapi.h)

  • Artículo

Compara dos rutas de acceso para determinar si comparten un prefijo común. Un prefijo es uno de estos tipos: "C:\", ".", "..", ".. \".

Sintaxis

int PathCommonPrefixA(
  [in]            LPCSTR pszFile1,
  [in]            LPCSTR pszFile2,
  [out, optional] LPSTR  achPath
);

Parámetros

[in] pszFile1

Tipo: LPCTSTR

Puntero a una cadena terminada en null de longitud MAX_PATH que contiene el nombre de la primera ruta de acceso.

[in] pszFile2

Tipo: LPCTSTR

Puntero a una cadena terminada en null de longitud MAX_PATH que contiene el segundo nombre de ruta de acceso.

[out, optional] achPath

Tipo: LPTSTR

Puntero a un búfer que recibe el prefijo común. Este búfer debe tener al menos MAX_PATH caracteres de tamaño. Si no hay ningún prefijo común, se establece en NULL.

Valor devuelto

Tipo: int

Devuelve el recuento de caracteres de prefijo comunes en la ruta de acceso. Si el puntero del búfer de salida no es NULL, estos caracteres se copian en el búfer de salida.

Comentarios

Nota

El encabezado shlwapi.h define PathCommonPrefix como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shlwapi.h
Library Shlwapi.lib
Archivo DLL Shlwapi.dll (versión 4.71 o posterior)