Função FindFirstFileNameTransactedW (winbase.h)

[A Microsoft recomenda fortemente que os desenvolvedores utilizem meios alternativos para atender às necessidades do seu aplicativo. Muitos cenários para os quais o TxF foi desenvolvido podem ser obtidos por meio de técnicas mais simples e prontamente disponíveis. Além disso, o TxF pode não estar disponível em versões futuras do Microsoft Windows. Para obter mais informações e alternativas ao TxF, confira Alternativas ao uso do NTFS transacional.]

Cria uma enumeração de todos os links físicos para o arquivo especificado como uma operação transacionada. A função retorna um identificador para a enumeração que pode ser usada em chamadas subsequentes para a função FindNextFileNameW.

Sintaxe

HANDLE FindFirstFileNameTransactedW(
  [in]           LPCWSTR lpFileName,
  [in]           DWORD   dwFlags,
  [in, out]      LPDWORD StringLength,
  [in, out]      PWSTR   LinkName,
  [in, optional] HANDLE  hTransaction
);

Parâmetros

[in] lpFileName

O nome do arquivo.

O arquivo deve residir no computador local; caso contrário, a função falhará e o último código de erro será definido como ERROR_TRANSACTIONS_UNSUPPORTED_REMOTE (6805).

[in] dwFlags

Reservados; especifique zero (0).

[in, out] StringLength

O tamanho do buffer apontado pelo parâmetro LinkName , em caracteres. Se essa chamada falhar e o erro for ERROR_MORE_DATA (234), o valor retornado por esse parâmetro será o tamanho para o qual o buffer apontado por LinkName deverá conter todos os dados.

[in, out] LinkName

Um ponteiro para um buffer para armazenar o nome do primeiro link encontrado para lpFileName.

[in, optional] hTransaction

Um identificador para a transação. Esse identificador é retornado pela função CreateTransaction .

Valor retornado

Se a função for bem-sucedida, o valor retornado será um identificador de pesquisa que pode ser usado com a função FindNextFileNameW ou fechado com a função FindClose .

Se a função falhar, o valor retornado será INVALID_HANDLE_VALUE (0xffffffff). Para
obtenha informações de erro estendidas, chame a função GetLastError .

Comentários

No Windows 8 e Windows Server 2012, essa função é compatível com as tecnologias a seguir.

O SMB 3.0 não dá suporte a TxF.

Requisitos

Confira também

Funções de gerenciamento de arquivos

FindClose

FindNextFileNameW

NTFS transacional