Función PathBuildRootW (shlwapi.h)

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

Sintaxis

LPWSTR PathBuildRootW(
  [out] LPWSTR pszRoot,
  [in]  int    iDrive
);

Parámetros

[out] pszRoot

Tipo: LPTSTR

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

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.

Comentarios

Nota

El encabezado shlwapi.h define PathBuildRoot como un 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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

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)