Fonction FindFirstFileNameTransactedW (winbase.h)
[Microsoft recommande vivement aux développeurs d’utiliser d’autres moyens pour répondre aux besoins de votre application. De nombreux scénarios utilisant TxF peuvent être réalisés à l’aide de techniques plus simples et plus facilement disponibles. En outre, TxF peut ne pas être disponible dans les versions à venir de Microsoft Windows. Pour plus d’informations et les alternatives à TxF, consultez Alternatives à l’utilisation de Transactionnel NTFS.]
Crée une énumération de tous les liens en dur vers le fichier spécifié en tant qu’opération transactionnelle. La fonction retourne un gestionnaire à l’énumération qui peut être utilisé lors des appels suivants à la fonction FindNextFileNameW.
Syntaxe
HANDLE FindFirstFileNameTransactedW(
[in] LPCWSTR lpFileName,
[in] DWORD dwFlags,
[in, out] LPDWORD StringLength,
[in, out] PWSTR LinkName,
[in, optional] HANDLE hTransaction
);
Paramètres
[in] lpFileName
Nom du fichier.
Le fichier doit résider sur l’ordinateur local ; sinon, la fonction échoue et le dernier code d’erreur est défini sur ERROR_TRANSACTIONS_UNSUPPORTED_REMOTE (6805).
[in] dwFlags
Réservés au; spécifiez zéro (0).
[in, out] StringLength
Taille de la mémoire tampon vers laquelle pointe le paramètre LinkName , en caractères. Si cet appel échoue et que l’erreur est ERROR_MORE_DATA (234), la valeur retournée par ce paramètre est la taille que doit avoir la mémoire tampon pointée par LinkName pour contenir toutes les données.
[in, out] LinkName
Pointeur vers une mémoire tampon pour stocker le premier nom de lien trouvé pour lpFileName.
[in, optional] hTransaction
Handle de la transaction. Ce handle est retourné par la fonction CreateTransaction .
Valeur retournée
Si la fonction réussit, la valeur de retour est un handle de recherche qui peut être utilisé avec la fonction FindNextFileNameW ou fermé avec la fonction FindClose .
Si la fonction échoue, la valeur de retour est INVALID_HANDLE_VALUE (0xffffffff). À
obtenez des informations d’erreur étendues, appelez la fonction GetLastError .
Remarques
Dans Windows 8 et Windows Server 2012, cette fonction est prise en charge par les technologies suivantes.
| Technologie | Prise en charge |
|---|---|
| Protocole Server Message Block (SMB) 3.0 | No |
| Basculement transparent SMB 3.0 (TFO) | No |
| SMB 3.0 avec partages de fichiers avec montée en puissance parallèle (SO) | No |
| Système de fichiers du volume partagé de cluster (CsvFS) | No |
| Système de fichiers résilient (ReFS) | No |
SMB 3.0 ne prend pas en charge TxF.
Configuration requise
| Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | winbase.h (inclure Windows.h) |
| Bibliothèque | Kernel32.lib |
| DLL | Kernel32.dll |