Función FindFirstVolumeMountPointA (winbase.h)
Recupera el nombre de una carpeta montada en el volumen especificado. FindFirstVolumeMountPoint se usa para comenzar a examinar las carpetas montadas en un volumen.
Sintaxis
HANDLE FindFirstVolumeMountPointA(
[in] LPCSTR lpszRootPathName,
[out] LPSTR lpszVolumeMountPoint,
[in] DWORD cchBufferLength
);
Parámetros
[in] lpszRootPathName
Ruta de acceso GUID de volumen para el volumen que se va a buscar carpetas montadas. Se requiere una barra diagonal inversa final.
[out] lpszVolumeMountPoint
Puntero a un búfer que recibe el nombre de la primera carpeta montada que se encuentra.
[in] cchBufferLength
Longitud del búfer que recibe la ruta de acceso a la carpeta montada, en TCHARs.
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto es un identificador de búsqueda usado en una llamada posterior a la FindNextVolumeMountPoint y funciones de FindVolumeMountPointClose.
Si la función no encuentra una carpeta montada en el volumen, el valor devuelto es el código de error INVALID_HANDLE_VALUE. Para obtener información de error extendida, llame a GetLastError.
Observaciones
La función FindFirstVolumeMountPoint abre un identificador de búsqueda de carpetas montado y devuelve información sobre la primera carpeta montada que se encuentra en el volumen especificado. Una vez establecido el identificador de búsqueda, puede usar la función FindNextVolumeMountPoint para buscar otras carpetas montadas. Cuando ya no se necesite el identificador de búsqueda, ciérrelo con la función FindVolumeMountPointClose.
Las FindFirstVolumeMountPoint, FindNextVolumeMountPointy funciones FindVolumeMountPointClose devuelven rutas de acceso a carpetas montadas para un volumen especificado. No devuelven letras de unidad ni volumen rutas de acceso GUID. Para obtener información sobre cómo enumerar el volumen rutas de acceso guid de un volumen, consulte Enumerar rutas de acceso GUID de volumen.
No debe asumir ninguna correlación entre el orden de las carpetas montadas que devuelven estas funciones y el orden de las carpetas montadas que devuelven otras funciones o herramientas.
En Windows 8 y Windows Server 2012, esta función es compatible con las siguientes tecnologías.
| Tecnología | Soportado |
|---|---|
| Protocolo bloque de mensajes del servidor (SMB) 3.0 | No |
| Conmutación por error transparente (TFO) de SMB 3.0 | No |
| SMB 3.0 con recursos compartidos de archivos de escalabilidad horizontal (SO) | No |
| Sistema de archivos de volumen compartido de clúster (CsvFS) | No |
| Sistema de archivos resistente (ReFS) | No |
SMB no admite funciones de administración de volúmenes. CsvFS no admite la adición de puntos de montaje en un volumen CSV. ReFS no indexa puntos de montaje.
Nota
El encabezado winbase.h define FindFirstVolumeMountPoint 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 XP [solo aplicaciones de escritorio] |
| servidor mínimo admitido | Windows Server 2003 [solo aplicaciones de escritorio] |
| de la plataforma de destino de |
Windows |
| encabezado de |
winbase.h (incluya Windows.h) |
| biblioteca de |
Kernel32.lib |
| DLL de |
Kernel32.dll |
Consulte también
funciones de administración de volúmenes de