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

Voir aussi

Fonctions de gestion des fichiers

FindClose

FindNextFileNameW

NTFS transactionnel