code de contrôle FSCTL_ENUM_OVERLAY
Le code de contrôle FSCTL_ENUM_OVERLAY énumère toutes les sources de données d’un fournisseur de stockage pour un volume spécifié.
Pour effectuer cette opération, appelez FltFsControlFile ou ZwFsControlFile avec les paramètres suivants.
Paramètres
Instance [in] : FltFsControlFile uniquement. Pointeur de instance opaque pour l’appelant. Ce paramètre est obligatoire et ne peut pas avoir la valeur NULL.
FileObject [in] : FltFsControlFile uniquement. Objet pointeur de fichier spécifiant le volume à démonter. Ce paramètre est obligatoire et ne peut pas avoir la valeur NULL.
FileHandle [in] : ZwFsControlFile uniquement. Handle de fichier du volume à monter. Ce paramètre est obligatoire et ne peut pas avoir la valeur NULL.
FsControlCode [in] : code de contrôle pour l’opération. Utilisez FSCTL_REMOVE_OVERLAY pour cette opération.
InputBuffer [in] : pointeur vers la mémoire tampon d’entrée, qui doit contenir une structure WOF_EXTERNAL_INFO .
InputBufferLength [in] : défini sur sizeof(WOF_EXTERNAL_INFO).
OutputBuffer [out] : pointeur vers une mémoire tampon de sortie qui recevra une ou plusieurs structures WIM_PROVIDER_OVERLAY_ENTRY pour les sources de données qui sauvegardent le volume.
OutputBufferLength [out] : taille de la mémoire tampon pointée par OutputBuffer, en octets.
LengthReturned [out] : spécifie le nombre d’octets écrits dans OutputBuffer lors de la réussite de l’exécution.
Bloc d’état
FltFsControlFile ou ZwFsControlFile retourne STATUS_SUCCESS si l’opération réussit. Sinon, la fonction appropriée peut retourner l’une des valeurs NTSTATUS suivantes.
| Code | Signification |
|---|---|
| STATUS_ACCESS_DENIED | Le demandeur ne dispose pas de privilèges administratifs. |
| STATUS_BUFFER_TOO_SMALL | La longueur de la mémoire tampon de sortie pointée par OutputBuffer et spécifiée par OutputBufferLength est trop petite. |
| STATUS_INTERNAL_ERROR | Le volume demandé n’est pas accessible. |
| STATUS_INVALID_DEVICE_REQUEST | Le service de sauvegarde n’est pas présent ou n’est pas démarré. |
Remarques
Lors de l’énumération des sources de données pour le fournisseur WIM, la mémoire tampon de sortie contient un tableau de structures WIM_PROVIDER_OVERLAY_ENTRY . La taille de la mémoire tampon de sortie doit être suffisamment grande pour contenir toutes les entrées de superposition, sinon l’appel retourne STATUS_BUFFER_TOO_SMALL.
D’autres fournisseurs de stockage définissent leurs propres structures d’énumération spécifiques.
Configuration requise
| Type d’exigence | Condition requise |
|---|---|
| Client minimal pris en charge | Mise à jour Windows 8.1 |
| En-tête | Ntifs.h (inclure Ntifs.h ou Fltkernel.h) |