Función FindFirstStreamTransactedW (winbase.h)

Artículo
08/27/2023

[Microsoft recomienda encarecidamente que los desarrolladores usen medios alternativos para lograr las necesidades de la aplicación. Muchos escenarios para los que se desarrolló TxF se pueden lograr mediante técnicas más sencillas y disponibles. Además, es posible que TxF no esté disponible en versiones futuras de Microsoft Windows. Para más información y alternativas a TxF, consulte Alternativas al uso de NTFS transaccional].

Enumera la primera secuencia del archivo o directorio especificados como una operación de transacción.

Sintaxis

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

Parámetros

[in] lpFileName

Nombre de archivo completo.

El archivo debe residir en el equipo local; de lo contrario, se produce un error en la función y el último código de error se establece en ERROR_TRANSACTIONS_UNSUPPORTED_REMOTE (6805).

[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 archivo. El formato de estos datos depende del valor del parámetro InfoLevel .

dwFlags

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

[in] hTransaction

Identificador de la transacción. La función CreateTransaction devuelve este identificador.

Valor devuelto

Si la función se ejecuta 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.

Comentarios

Todos los archivos contienen un flujo de datos predeterminado. En NTFS, los archivos también pueden contener uno o varios flujos de datos con nombre. En los sistemas de archivos FAT, los archivos no pueden tener más que el flujo de datos predeterminado y, por lo tanto, esta función no devolverá resultados válidos cuando se use en archivos del sistema de archivos FAT. Esta función funciona en todos los sistemas de archivos que admiten vínculos duros; de lo contrario, la función devuelve ERROR_STATUS_NOT_IMPLEMENTED (6805).

La función FindFirstStreamTransactedW abre un identificador de búsqueda y devuelve información sobre la primera secuencia del archivo o directorio especificados. En el caso de los archivos, siempre es el flujo de datos predeterminado: ::$DATA. Una vez establecido el identificador de búsqueda, úselo en la función FindNextStreamW para buscar otras secuencias en el archivo o directorio especificados. Cuando ya no se necesite el identificador de búsqueda, 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	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 3.0 no admite TxF.

Requisitos

Requisito	Value
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	winbase.h (incluya Windows.h)
Library	Kernel32.lib
Archivo DLL	Kernel32.dll