Freigeben über

FSCTL_TXFS_QUERY_RM_INFORMATION IOCTL (winioctl.h)

  • Artikel

Hinweis

Microsoft empfiehlt Entwicklern dringend, alternative Mittel zu verwenden, um die Anforderungen Ihrer Anwendung zu erfüllen. Viele Szenarios, für die TxF entwickelt wurde, können mit einfacheren und leichter verfügbaren Techniken erreicht werden. Darüber hinaus ist TxF in zukünftigen Versionen von Microsoft Windows möglicherweise nicht verfügbar. Weitere Informationen und Alternativen zu TxF finden Sie unter Alternativen zur Verwendung von Transaktions-NTFS.

Ruft Informationen für einen Ressourcen-Manager (RM) ab.

Um diesen Vorgang auszuführen, rufen Sie die Funktion DeviceIoControl mit den folgenden Parametern auf.

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
);

Hinweise

FSCTL_TXFS_QUERY_RM_INFORMATION ist ein synchroner Vorgang.

Wenn dieser Aufruf mit ERROR_BUFFER_TOO_SMALL fehlschlägt, gibt das BytesRequired-Element der TXFS_QUERY_RM_INFORMATION-Struktur an, wie groß der Puffer sein muss, damit der Aufruf erfolgreich zurückgegeben werden kann.

Wenn Sie eine Anwendung schreiben, die Server Message Block Protocol-Remoteclients unterstützt, müssen Sie diesen Steuerungscode verwenden, um den Ressourcen-Manager zu verwenden.

Der Ressourcen-Manager kann unabhängig von seinem Zustand abgefragt werden. wenn der RM nicht gestartet wird, wird ERROR_RM_NOT_ACTIVE zurückgegeben. Sie können die Informationen über den aktiven Bereich des Protokolls verwenden, um Entscheidungen darüber zu treffen, wie viel des Protokolls archiviert werden soll.

Refs: Dieser Code wird nicht unterstützt.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Kopfzeile winioctl.h (einschließlich Windows.h)

Weitere Informationen