Función PathBuildRootA (shlwapi.h)

Crea una ruta de acceso raíz a partir de un número de unidad determinado.

Sintaxis

LPSTR PathBuildRootA(
  [out] LPSTR pszRoot,
  [in]  int   iDrive
);

Parámetros

[out] pszRoot

Tipo: LPTSTR de

Puntero a la cadena que recibe la ruta de acceso raíz construida. Este búfer debe tener al menos cuatro caracteres de tamaño.

[in] iDrive

Tipo: int

Variable de tipo int que indica el número de unidad deseado. Debe estar entre 0 y 25.

Valor devuelto

Tipo: LPTSTR de

Devuelve la dirección de la ruta de acceso raíz construida. Si se produce un error en la llamada por cualquier motivo (por ejemplo, un número de unidad no válido), se devuelve szRoot sin cambios.

Observaciones

Nota

El encabezado shlwapi.h define PathBuildRoot 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 Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	shlwapi.h
biblioteca de	Shlwapi.lib
DLL de	Shlwapi.dll (versión 4.71 o posterior)