FSCTL_TXFS_QUERY_RM_INFORMATION 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.

Récupère les informations relatives à un gestionnaire de ressources (RM).

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

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

Remarques

FSCTL_TXFS_QUERY_RM_INFORMATION est une opération synchrone.

Si cet appel échoue avec ERROR_BUFFER_TOO_SMALL, le membre BytesRequired de la structure TXFS_QUERY_RM_INFORMATION spécifie la taille de la mémoire tampon pour que l’appel retourne correctement.

Si vous écrivez une application qui prend en charge les clients distants server Message Block Protocol, vous devez utiliser ce code de contrôle pour utiliser le gestionnaire de ressources.

Le gestionnaire de ressources peut être interrogé quel que soit son état ; si le RM n’est pas démarré, ERROR_RM_NOT_ACTIVE est retourné. Vous pouvez utiliser les informations sur la plage active du journal pour guider les décisions relatives à la quantité du journal à archiver.

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