Freigeben über

FSCTL_TXFS_LIST_TRANSACTION_LOCKED_FILES 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 Liste aller Dateien zurück, die derzeit durch die angegebene Transaktion gesperrt sind. Wenn der Rückgabewert ERROR_MORE_DATA lautet, wird die Länge des Puffers zurückgegeben, der zum Zeitpunkt dieses Aufrufs für die vollständige Liste der Dateien erforderlich ist.

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

Hinweise

FSCTL_TXFS_LIST_TRANSACTION_LOCKED_FILES ist ein synchroner Vorgang.

Die zurückgegebenen Dateipfadnamen sind relativ zum Volumestamm.

Die Anzahl der Dateien, die von einem Aufruf zum nächsten zurückgegeben werden, kann sich je nach Anzahl der aktiven Transaktionen zu einem bestimmten Zeitpunkt ändern. Wenn dieser Aufruf eine Anforderung für einen größeren Puffer zurückgibt, ist diese Größe möglicherweise für den nächsten Aufruf angemessen, basierend auf der Anzahl der aktiven Transaktionen zum Zeitpunkt des nächsten Aufrufs.

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