code de contrôle FSCTL_ENUM_OVERLAY

2025-07-11

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 d’instance opaque pour l’appelant. Ce paramètre est obligatoire et ne peut pas être NULL.
FileObject [in] : FltFsControlFile uniquement. Objet pointeur de fichier spécifiant le volume à démonté. Ce paramètre est obligatoire et ne peut pas être NULL.
FileHandle [in] : ZwFsControlFile uniquement. Handle de fichier du volume à démoner. Ce paramètre est obligatoire et ne peut pas être 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 saisie semi-automatique.

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	Sens
STATUS_ACCÈS_REFUSÉ	Le demandeur n’a pas de privilèges d’administration.
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.
ERREUR_INTERNE_STATUT	Le volume demandé n’est pas accessible.
STATUS_INVALID_DEVICE_REQUEST	Le service de stockage n’est pas présent ou ne démarre pas.

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 ou l’appel retourne STATUS_BUFFER_TOO_SMALL.

Des fournisseurs de stockage supplémentaires définissent leurs propres structures d’énumération spécifiques.