FSCTL_TXFS_LIST_TRANSACTION_LOCKED_FILES IOCTL (winioctl.h)

  • Article

Notes

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

Renvoie une liste de tous les fichiers actuellement verrouillés par la transaction spécifiée. Si la valeur de retour est ERROR_MORE_DATA, elle retourne la longueur de la mémoire tampon nécessaire pour contenir la liste complète des fichiers au moment de cet appel.

BOOL DeviceIoControl(
  (HANDLE) hDevice,                         // handle to device
  FSCTL_TXFS_LIST_TRANSACTION_LOCKED_FILES, // dwIoControlCode
  (LPVOID) lpInBuffer,                      // input buffer
  (DWORD) nInBufferSize,                    // size of input buffer
  (LPVOID) lpOutBuffer,                     // output buffer
  (DWORD) nOutBufferSize,                   // size of output buffer
  (LPDWORD) lpBytesReturned,                // number of bytes returned
  (LPOVERLAPPED) lpOverlapped );            // OVERLAPPED structure
);

Remarques

FSCTL_TXFS_LIST_TRANSACTION_LOCKED_FILES est une opération synchrone.

Les noms de chemin d’accès de fichier retournés sont relatifs à la racine du volume.

Le nombre de fichiers retournés d’un appel à l’autre peut changer en fonction du nombre de transactions actives à un moment donné. Si cet appel retourne une demande pour une mémoire tampon plus importante, cette taille peut ou ne pas être suffisante pour l’appel suivant, en fonction du nombre de transactions actives au moment de l’appel suivant.

Refs: Ce code n’est pas pris en charge.

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]
En-tête winioctl.h (inclure Windows.h)

Voir aussi