Lire en anglais

Partager via


FSCTL_TXFS_GET_TRANSACTED_VERSION IOCTL (winioctl.h)

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.

Retourne une structure TXFS_GET_TRANSACTED_VERSION. La structure identifie la version la plus récente du fichier spécifié, le numéro de version du descripteur.

Pour effectuer cette opération, appelez la fonction DeviceIoControl avec les paramètres suivants.

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

Remarques

FSCTL_TXFS_GET_TRANSACTED_VERSION est une opération synchrone.

Ce code de contrôle peut être utilisé pour suivre la dernière version d’un fichier de base. Pour un handle spécifié, la version de base est toujours la valeur de base retournée lors de l’ouverture du handle, mais la version la plus récente change en fonction des opérations de validation effectuées par une autre transaction. Si handle est alors fermé et ouvert à nouveau, la version de base et la dernière version sont mises à jour vers de nouvelles valeurs et toutes les opérations de validation suivantes de l’autre transaction modifient la dernière version.

Si vous tentez de récupérer la version de la racine d’un gestionnaire de ressources, la valeur TXFS_TRANSACTED_VERSION_NONTRANSACTED est retournée.

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