Fonction FindFirstStreamTransactedW (winbase.h)

Article
08/27/2023

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

Énumère le premier flux du fichier ou du répertoire spécifié en tant qu’opération transactionnelle.

Syntaxe

HANDLE FindFirstStreamTransactedW(
  [in]  LPCWSTR            lpFileName,
  [in]  STREAM_INFO_LEVELS InfoLevel,
  [out] LPVOID             lpFindStreamData,
        DWORD              dwFlags,
  [in]  HANDLE             hTransaction
);

Paramètres

[in] lpFileName

Nom de fichier complet.

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] InfoLevel

Niveau d’informations des données retournées. Ce paramètre est l’une des valeurs du type d’énumération STREAM_INFO_LEVELS .

Valeur	Signification
FindStreamInfoStandard 0	Les données sont retournées dans une structure WIN32_FIND_STREAM_DATA .

[out] lpFindStreamData

Pointeur vers une mémoire tampon qui reçoit les données du fichier. Le format de ces données dépend de la valeur du paramètre InfoLevel .

dwFlags

Réservé pour un usage futur. Ce paramètre doit être égal à zéro.

[in] 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é dans les appels suivants à la fonction FindNextStreamW .

Si la fonction échoue, la valeur de retour est INVALID_HANDLE_VALUE. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Tous les fichiers contiennent un flux de données par défaut. Sur NTFS, les fichiers peuvent également contenir un ou plusieurs flux de données nommés. Sur les systèmes de fichiers FAT, les fichiers ne peuvent pas avoir plus que le flux de données par défaut. Par conséquent, cette fonction ne retourne pas de résultats valides lorsqu’elle est utilisée sur les fichiers de système de fichiers FAT. Cette fonction fonctionne sur tous les systèmes de fichiers qui prennent en charge les liens durs ; sinon, la fonction retourne ERROR_STATUS_NOT_IMPLEMENTED (6805).

La fonction FindFirstStreamTransactedW ouvre un handle de recherche et retourne des informations sur le premier flux dans le fichier ou le répertoire spécifié. Pour les fichiers, il s’agit toujours du flux de données par défaut, ::$DATA. Une fois le handle de recherche établi, utilisez-le dans la fonction FindNextStreamW pour rechercher d’autres flux dans le fichier ou le répertoire spécifié. Lorsque le handle de recherche n’est plus nécessaire, il doit être fermé à l’aide de la fonction FindClose .

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

Condition requise	Valeur
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