Freigeben über

FSCTL_TXFS_GET_TRANSACTED_VERSION IOCTL (winioctl.h)

  • Artikel

Hinweis

Microsoft empfiehlt Entwicklern dringend, alternative Methoden 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.

Gibt eine TXFS_GET_TRANSACTED_VERSION-Struktur zurück. Die Struktur identifiziert die zuletzt committete Version der angegebenen Datei, die Versionsnummer des Handles.

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

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

Hinweise

FSCTL_TXFS_GET_TRANSACTED_VERSION ist ein synchroner Vorgang.

Dieser Steuerelementcode kann verwendet werden, um die neueste Version einer Basisdatei nachzuverfolgen. Bei einem angegebenen Handle ist die Basisversion immer der Basiswert, der beim Öffnen des Handles zurückgegeben wurde, aber die neueste Version ändert sich basierend auf allen Commitvorgängen, die eine andere Transaktion ausführt. Wenn das Handle geschlossen und erneut geöffnet wird, werden die Basisversion und die neueste Version auf neue Werte aktualisiert, und alle nachfolgenden Commitvorgänge der anderen Transaktion ändern die neueste Version.

Wenn Sie versuchen, die Version des Stammverzeichnisses eines Ressourcen-Managers abzurufen, wird der Wert TXFS_TRANSACTED_VERSION_NONTRANSACTED zurückgegeben.

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 (windows.h einschließen)

Weitere Informationen