FSCTL_ENUM_EXTERNAL_BACKING codice di controllo
Il codice di controllo FSCTL_ENUM_EXTERNAL_BACKING inizia o continua un'enumerazione di file in un volume con un'origine di backup. Per ogni completamento della richiesta, viene restituito un identificatore per il file supportato. Tutti i file supportati vengono enumerati indipendentemente dal provider esterno che esegue il backup. Le richieste successive FSCTL_ENUM_EXTERNAL_BACKING sono necessarie per enumerare tutti i file supportati nel volume.
Per eseguire questa operazione, chiamare FltFsControlFile o ZwFsControlFile con i parametri seguenti.
Parametri
Istanza [in]: Solo FltFsControlFile . Puntatore istanza opaca per il chiamante. Questo parametro è obbligatorio e non può essere NULL.
FileObject [in]: Solo FltFsControlFile . Oggetto puntatore file che specifica il volume da smontare. Questo parametro è obbligatorio e non può essere NULL.
FileHandle [in]: ZwFsControlFile solo. Handle di file del volume da smontare. Questo parametro è obbligatorio e non può essere NULL.
FsControlCode [in]: Codice di controllo per l'operazione. Usare FSCTL_ENUM_EXTERNAL_BACKING per questa operazione.
InputBuffer [in]: Nessuno. Impostare su NULL.
InputBufferLength [in]: Impostare su 0.
OutputBuffer [out]: puntatore al buffer di output, che deve avere dimensioni sufficienti per ricevere una o più strutture WOF_EXTERNAL_FILE_ID .
OutputBufferLength [out]: Dimensioni del buffer di output a cui fa riferimento OutputBuffer. OutputBufferLength deve essere >= sizeof(WOF_EXTERNAL_FILE_ID).
LengthReturned [out]: specifica il numero di byte scritti in OutputBuffer al completamento corretto.
Blocco dello stato
FltFsControlFile o ZwFsControlFile restituisce STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, la funzione appropriata potrebbe restituire uno dei valori NTSTATUS seguenti.
| Codice | Significato |
|---|---|
| STATUS_ACCESS_DENIED | Il richiedente non ha privilegi amministrativi. |
| STATUS_BUFFER_TOO_SMALL | La lunghezza del buffer di output puntata da OutputBuffer e specificata da OutputBufferLength è troppo piccola. |
| STATUS_NO_MORE_FILES | Nessun altro file nel volume ha un'origine di backup. |
| STATUS_INTERNAL_ERROR | Il volume richiesto non è accessibile. |
| STATUS_INVALID_DEVICE_REQUEST | Il servizio di backup non è presente o non è avviato. |
Commenti
La struttura WOF_EXTERNAL_FILE_ID restituita in OutputBuffer contiene identificatori di file univoci per i file supportati. La struttura è definita in ntifs.h come segue.
typedef struct _WOF_EXTERNAL_FILE_ID {
FILE_ID_128 FileId;
} WOF_EXTERNAL_FILE_ID, *PWOF_EXTERNAL_FILE_ID;
Una richiesta di FSCTL_ENUM_EXTERNAL_BACKING viene rilasciata successivamente per recuperare gli identificatori per ogni file nel volume con origine di backup. Quando vengono enumerati tutti i file, viene restituito il codice di stato STATUS_NO_MORE_FILES.
Requisiti
| Tipo di requisito | Requisito |
|---|---|
| Client minimo supportato | Windows 8.1 Update |
| Intestazione | Ntifs.h (include Ntifs.h o Fltkernel.h) |