FSCTL_TXFS_QUERY_RM_INFORMATION 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.

Recupera informazioni per un resource manager (RM).

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

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

Commenti

FSCTL_TXFS_QUERY_RM_INFORMATION è un'operazione sincrona.

Se questa chiamata ha esito negativo con ERROR_BUFFER_TOO_SMALL, il membro BytesRequired della struttura TXFS_QUERY_RM_INFORMATION specifica la dimensione del buffer affinché la chiamata restituisca correttamente.

Se si sta scrivendo un'applicazione che supporta i client remote server Message Block Protocol, è necessario usare questo codice di controllo per usare gestione risorse.

Il gestore risorse può essere sottoposto a query indipendentemente dal relativo stato; se l'RM non viene avviato, viene restituito ERROR_RM_NOT_ACTIVE. È possibile usare le informazioni sull'intervallo attivo del log per prendere decisioni sulla quantità di log da archiviare.

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