Función FindNextVolumeMountPointA (winbase.h)
Continúa una búsqueda de carpetas montadas iniciada por una llamada a la función FindFirstVolumeMountPoint. FindNextVolumeMountPoint busca una carpeta montada por llamada.
Sintaxis
BOOL FindNextVolumeMountPointA(
[in] HANDLE hFindVolumeMountPoint,
[out] LPSTR lpszVolumeMountPoint,
[in] DWORD cchBufferLength
);
Parámetros
[in] hFindVolumeMountPoint
Identificador de búsqueda de carpetas montado devuelto por una llamada anterior a la función FindFirstVolumeMountPoint .
[out] lpszVolumeMountPoint
Puntero a un búfer que recibe el nombre de la carpeta montada que se encuentra.
[in] cchBufferLength
Longitud del búfer que recibe el nombre de carpeta montado, en TCHAR.
Valor devuelto
Si la función se realiza correctamente, el valor devuelto es distinto de cero.
Si la función no se realiza correctamente, el valor devuelto es cero. Para obtener información de error extendida, llame a GetLastError. Si no se pueden encontrar más carpetas montadas, la función GetLastError devuelve el código de error ERROR_NO_MORE_FILES . En ese caso, cierre la búsqueda con la función FindVolumeMountPointClose .
Comentarios
Una vez establecido el identificador de búsqueda llamando a FindFirstVolumeMountPoint, puede usar la función FindNextVolumeMountPoint para buscar otras carpetas montadas.
Las funciones FindFirstVolumeMountPoint, FindNextVolumeMountPoint y FindVolumeMountPointClose devuelven rutas de acceso a carpetas montadas para un volumen especificado. No devuelven letras de unidad ni rutas guid de volumen. Para obtener información sobre cómo enumerar las rutas de acceso guid de volumen de un volumen, vea Enumerar rutas de acceso GUID de volumen.
No debe asumir ninguna correlación entre el orden de las carpetas montadas que se devuelven con 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 tecnologías siguientes.
| Tecnología | Compatible |
|---|---|
| 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 a errores (ReFS) | No |
SMB no admite funciones de administración de volúmenes. CsvFS no admite la adición de un punto de montaje en un volumen CSV. ReFS no indexa los puntos de montaje.
Nota
El encabezado winbase.h define FindNextVolumeMountPoint 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 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
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows XP [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2003 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | winbase.h (incluya Windows.h) |
| Library | Kernel32.lib |
| Archivo DLL | Kernel32.dll |