Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
Řídicí kód FSCTL_ENUM_EXTERNAL_BACKING začíná nebo pokračuje ve výčtu souborů na svazku, který má záložní zdroj. Pro každé úspěšné dokončení požadavku se vrátí identifikátor zálohovaného souboru. Všechny zálohované soubory jsou výčty bez ohledu na to, který externí poskytovatel ho zálohuje. Následné FSCTL_ENUM_EXTERNAL_BACKING požadavky se vyžadují k vytvoření výčtu všech zálohovaných souborů na svazku.
Chcete-li provést tuto operaci, zavolejte FltFsControlFile nebo ZwFsControlFile s následujícími parametry.
Parametry
Instance [in]: Pouze FltFsControlFile . Neprůzný ukazatel instance volajícího. Tento parametr je povinný a nesmí mít hodnotu NULL.
FileObject [in]: Pouze FltFsControlFile . Objekt ukazatele souboru určující svazek, který se má odpojit. Tento parametr je povinný a nesmí mít hodnotu NULL.
FileHandle [in]: Pouze ZwFsControlFile . Popisovač souboru svazku, který se má odpojit. Tento parametr je povinný a nesmí mít hodnotu NULL.
FsControlCode [in]: Řídicí kód operace. Pro tuto operaci použijte FSCTL_ENUM_EXTERNAL_BACKING .
InputBuffer [in]: Žádné. Nastavte na hodnotu NULL.
InputBufferLength [in]: Nastaveno na hodnotu 0.
OutputBuffer [out]: Ukazatel na výstupní vyrovnávací paměť, který musí mít dostatečně velkou velikost pro příjem jedné nebo více WOF_EXTERNAL_FILE_ID struktur.
OutputBufferLength [out]: Velikost výstupní vyrovnávací paměti, na kterou odkazuje OutputBuffer. OutputBufferLength musí být >= sizeof(WOF_EXTERNAL_FILE_ID).
LengthReturned [out]: Určuje počet bajtů zapsaných do outputBuffer při úspěšném dokončení.
Blok stavu
FltFsControlFile nebo ZwFsControlFile vrátí STATUS_SUCCESS, pokud operace proběhne úspěšně. V opačném případě může příslušná funkce vrátit jednu z následujících hodnot NTSTATUS.
| Code | Význam |
|---|---|
| STAV_PŘÍSTUP_ODMÍTNUT | Žadatel nemá oprávnění správce. |
| STATUS_BUFFER_TOO_SMALL | Délka výstupní vyrovnávací paměti odkazované na OutputBuffer a určená outputBufferLength je příliš malá. |
| STATUS_NO_MORE_FILES | Žádné další soubory na svazku nemají záložní zdroj. |
| STATUS_INTERNAL_ERROR | Požadovaný svazek není přístupný. |
| STATUS_INVALID_DEVICE_REQUEST | Backingová služba není k dispozici nebo není spuštěna. |
Poznámky
Struktura WOF_EXTERNAL_FILE_ID vrácená v outputBufferu obsahuje jedinečné identifikátory souborů pro zálohované soubory. Struktura je definována v ntifs.h jako následující.
typedef struct _WOF_EXTERNAL_FILE_ID {
FILE_ID_128 FileId;
} WOF_EXTERNAL_FILE_ID, *PWOF_EXTERNAL_FILE_ID;
Požadavek FSCTL_ENUM_EXTERNAL_BACKING se vydává postupně, aby se načetly identifikátory pro každý soubor na svazku, který má záložní zdroj. Při výčtu všech souborů se vrátí stavový kód STATUS_NO_MORE_FILES.
Požadavky
| Typ požadavku | Požadavek |
|---|---|
| Minimální podporovaný klient | Windows 8.1 Aktualizace |
| Záhlaví | Ntifs.h (včetně Ntifs.h nebo Fltkernel.h) |