FSCTL_TXFS_GET_TRANSACTED_VERSION IOCTL (winioctl.h)

  • Articolo

Nota

Microsoft consiglia vivamente agli sviluppatori di usare mezzi alternativi per raggiungere le esigenze dell'applicazione. Molti scenari sviluppati da TxF possono essere ottenuti tramite tecniche più semplici e più leggibili. 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 una struttura TXFS_GET_TRANSACTED_VERSION . La struttura identifica la versione di commit più recente del file specificato, il numero di versione dell'handle.

Per eseguire questa operazione, chiamare la funzione DeviceIoControl con i parametri seguenti.

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

Commenti

FSCTL_TXFS_GET_TRANSACTED_VERSION è un'operazione sincrona.

Questo codice di controllo può essere usato per tenere traccia della versione più recente di un file di base. Per un handle specificato, la versione di base è sempre il valore di base restituito quando l'handle è stato aperto, ma la versione più recente cambia in base a qualsiasi operazione di commit eseguita da un'altra transazione. Se handle viene chiuso e aperto di nuovo, la versione di base e la versione più recente vengono aggiornate ai nuovi valori e alle operazioni di commit successive dall'altra transazione cambiano la versione più recente.

Se si tenta di recuperare la versione della radice di un resource manager, viene restituito il valore TXFS_TRANSACTED_VERSION_NONTRANSACTED .

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