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.

SMB 3.0 no admite TxF.

Requisitos

Vea también

Funciones de administración de archivos

FindClose

FindNextFileNameW

NTFS de transacciones