FSCTL_TXFS_LIST_TRANSACTION_LOCKED_FILES IOCTL (winioctl.h)

  • Articolo

Nota

Microsoft consiglia vivamente agli sviluppatori di usare mezzi alternativi per soddisfare le esigenze dell'applicazione. Molti scenari per cui è stato sviluppato TxF possono essere ottenuti tramite tecniche più semplici e più facilmente disponibili. Inoltre, TxF potrebbe non essere disponibile nelle versioni future di Microsoft Windows. Per altre informazioni e alternative a TxF, vedere Alternative all'uso di NTFS transazionale.

Restituisce un elenco di tutti i file attualmente bloccati dalla transazione specificata. Se il valore restituito è ERROR_MORE_DATA, restituisce la lunghezza del buffer necessaria per contenere l'elenco completo dei file al momento della chiamata.

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

Commenti

FSCTL_TXFS_LIST_TRANSACTION_LOCKED_FILES è un'operazione sincrona.

I nomi dei percorsi file restituiti sono relativi alla radice del volume.

Il numero di file restituiti da una chiamata alla successiva può cambiare a seconda del numero di transazioni attive in un determinato momento. Se questa chiamata restituisce una richiesta per un buffer di dimensioni maggiori, tale dimensione può o meno essere adeguata per la chiamata successiva, in base al numero di transazioni attive al momento della chiamata successiva.

Refs: Questo codice non è supportato.

Requisiti

Requisito Valore
Client minimo supportato Windows Vista [solo app desktop]
Server minimo supportato Windows Server 2008 [solo app desktop]
Intestazione winioctl.h (include Windows.h)

Vedi anche