Función FindFirstStreamW (fileapi.h)

Artículo
08/23/2023

Enumera la primera secuencia con un tipo de secuencia ::$DATA en el archivo o directorio especificados.

Para realizar esta operación como una operación de transacción, use la función FindFirstStreamTransactedW .

Sintaxis

HANDLE FindFirstStreamW(
  [in]  LPCWSTR            lpFileName,
  [in]  STREAM_INFO_LEVELS InfoLevel,
  [out] LPVOID             lpFindStreamData,
        DWORD              dwFlags
);

Parámetros

[in] lpFileName

Nombre de archivo completo.

[in] InfoLevel

Nivel de información de los datos devueltos. Este parámetro es uno de los valores del tipo de enumeración STREAM_INFO_LEVELS .

Valor	Significado
FindStreamInfoStandard 0	Los datos se devuelven en una estructura WIN32_FIND_STREAM_DATA .

[out] lpFindStreamData

Puntero a un búfer que recibe los datos del flujo de archivos. El formato de estos datos depende del valor del parámetro InfoLevel .

dwFlags

Reservado para uso futuro. Este parámetro debe ser cero.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es un identificador de búsqueda que se puede usar en llamadas posteriores a la función FindNextStreamW .

Si se produce un error en la función, el valor devuelto es INVALID_HANDLE_VALUE. Para obtener información de error extendida, llame a GetLastError.

Si no se encuentra ningún flujo, se produce un error en la función y GetLastError devuelve ERROR_HANDLE_EOF (38).

Si el sistema de archivos no admite secuencias, se produce un error en la función y GetLastError devuelve ERROR_INVALID_PARAMETER (87).

Comentarios

La función FindFirstStreamW abre un identificador de búsqueda y devuelve información sobre la primera secuencia de $DATA en el archivo o directorio especificados. En el caso de los archivos, siempre es el flujo de datos predeterminado sin nombre, "::$DATA". Los directorios no tienen $DATA secuencias de forma predeterminada y no pueden tener un flujo de datos sin nombre, pero pueden haber establecido flujos de datos con nombre una vez creados. Una vez establecido el identificador de búsqueda, úselo en llamadas a la función FindNextStreamW para buscar otras secuencias en el archivo o directorio especificados. Cuando el identificador de búsqueda ya no es necesario, debe cerrarse mediante la función FindClose .

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	Sí
SMB 3.0 con recursos compartidos de archivos de escalabilidad horizontal (SO)	Sí
Sistema de archivos de Volumen compartido de clúster (CsvFS)	Sí
Sistema de archivos resistente a errores (ReFS)	Sí

SMB 3.0 admite la lista de secuencias menores o iguales que 64K.

Requisitos


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