Función FindFirstFileNameTransactedW (winbase.h)
[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].
Crea una enumeración de todos los vínculos físicos al archivo especificado como una operación de transacción. La función devuelve un identificador a la enumeración que se puede usar en las llamadas posteriores a la función FindNextFileNameW.
Sintaxis
HANDLE FindFirstFileNameTransactedW(
[in] LPCWSTR lpFileName,
[in] DWORD dwFlags,
[in, out] LPDWORD StringLength,
[in, out] PWSTR LinkName,
[in, optional] HANDLE hTransaction
);
Parámetros
[in] lpFileName
Nombre del archivo.
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] dwFlags
Reservados; especifique cero (0).
[in, out] StringLength
Tamaño del búfer al que apunta el parámetro LinkName , en caracteres. Si se produce un error en esta llamada y el error es ERROR_MORE_DATA (234), el valor devuelto por este parámetro es el tamaño al que debe contener todos los datos el búfer al que apunta LinkName .
[in, out] LinkName
Puntero a un búfer para almacenar el nombre del primer vínculo encontrado para lpFileName.
[in, optional] 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 con la función FindNextFileNameW o cerrada con la función FindClose .
Si se produce un error en la función, el valor devuelto es INVALID_HANDLE_VALUE (0xffffffff). En
obtenga información de error extendida, llame a la función GetLastError .
Comentarios
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
| 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 (incluye Windows.h) |
| Library | Kernel32.lib |
| Archivo DLL | Kernel32.dll |