winbase.h


GetFullPathName

La función GetFullPathName recupera el camino completo y nombre de fichero del fichero especificado.

Sintaxis

DWORD GetFullPathName(
    LPCTSTR lpFileName,   // dirección de nombre de fichero del que se busca el camino
    DWORD nBufferLength,  // tamaño, en caracteres, del buffer del camino
    LPTSTR lpBuffer,      // dirección del buffer del camino
    LPTSTR *lpFilePart    // dirección del nombre del fichero en el camino
   );

Parámetros

lpFileName: apunta a una cadena terminada en cero que especifica un nombre de fichero válido. Esta cadena puede usar tanto nombres cortos (en el formato 8.3) como nombres largos.

nBufferLength: especifica el tamaño, en caracteres, del buffer para la unidad de almacenamiento y camino.

lpBuffer: apunta al buffer que contiene la cadena terminada en cero para el nombre de la undidad de almacenamiento y camino.

lpFilePart: apunta a una variable que recibe la dirección (dentro de lpBuffer) del componente final correspondiente al nombre del fichero dentro del camino. Este componente de nombre de fichero es el nombre largo, si existe, en lugar del nombre de fichero en el formato 8.3.

Valor de retorno

Si la función GetFullPathName tiene éxito, el valor de retorno es la longitud, en caracteres, de la cadena copiada a lpBuffer, sin incluir el carácter nulo terminador.

Si el buffer lpBuffer es demasiado pequeño, el valor de retorno es el tamaño del buffer, en caracteres, requerido para contener el camino.

Si la función falla, el valor de retorno es cero. Para obtener información adicional sobre el error, llamar a GetLastError.

Observaciones

La función GetFullPathName fusiona el nombre de la unidad actual y directorio con el nombre de fichero especificado para determinar el camino completo y nombre de fichero del fichero especificado. También calcula la dirección de la parte de nombre de fichero dentro del camino completo y nombre de fichero. Esta función no verifica que el camino y nombre de fichero resultante sean válidos o que se refieran a un fichero existente en el volumen asociado.