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