Función FindNextFileNameW (fileapi.h)

  • Artículo

Continúa enumerando los vínculos físicos a un archivo mediante el identificador devuelto por una llamada correcta a la función FindFirstFileNameW.

Sintaxis

BOOL FindNextFileNameW(
  [in]      HANDLE  hFindStream,
  [in, out] LPDWORD StringLength,
  [in, out] PWSTR   LinkName
);

Parámetros

[in] hFindStream

Identificador de la enumeración devuelta por una llamada correcta a FindFirstFileNameW.

[in, out] StringLength

Tamaño del parámetro LinkName , en caracteres. Si se produce un error en esta llamada y el error es ERROR_MORE_DATA, el valor devuelto por este parámetro es el tamaño que LinkName debe contener todos los datos.

[in, out] LinkName

Puntero a un búfer para almacenar el nombre del primer vínculo encontrado para lpFileName.

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 (0). Para obtener información de error extendida, llame a GetLastError.

Si no se encuentra ningún archivo coincidente, la función GetLastError devuelve ERROR_HANDLE_EOF.

Comentarios

Si la función devuelve TRUE, hay vínculos más duros para enumerar.

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 Sí
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) Sí
Sistema de archivos resistente a errores (ReFS) Sí

Requisitos

   
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado fileapi.h (incluya Windows.h, WinBase.h)
Library Kernel32.lib
Archivo DLL Kernel32.dll

Vea también

Funciones de administración de archivos

FindClose

FindFirstFileNameW