Função FindFirstFileNameTransactedW (winbase.h)

  • Artigo

[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.

Tecnologia Com suporte
Protocolo SMB (SMB) 3.0 Não
TFO (Failover transparente) do SMB 3.0 Não
SMB 3.0 com compartilhamentos de arquivos de expansão (SO) Não
Sistema de arquivos de Volume Compartilhado Clusterizado (CsvFS) Não
ReFS (Sistema de Arquivos Resiliente) Não
 

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

Requisitos

   
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho winbase.h (incluir Windows.h)
Biblioteca Kernel32.lib
DLL Kernel32.dll

Confira também

Funções de gerenciamento de arquivos

FindClose

FindNextFileNameW

NTFS transacional