code de contrôle FSCTL_ENUM_OVERLAY

Article
03/14/2023

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.