FltMupGetProviderInfoFromFileObject, fonction (fltkernel.h)

FltMupGetProviderInfoFromFileObject récupère les informations du fournisseur correspondant à un objet de fichier.

Syntaxe

NTSTATUS FLTAPI FltMupGetProviderInfoFromFileObject(
  PFLT_INSTANCE Instance,
  PFILE_OBJECT  FileObject,
  ULONG         Level,
  PVOID         Buffer,
  PULONG        BufferSize
);

Paramètres

Instance

[in] Pointeur opaque vers l’instance de filtre associée à cet objet de fichier. Ce paramètre est obligatoire et ne peut pas être NULL.

FileObject

[in] Pointeur vers l’objet de fichier pour lequel les informations du fournisseur doivent être récupérées. Ce paramètre est obligatoire et ne peut pas être NULL.

Level

[in] Niveau d’informations que cette routine doit retourner. Pour plus d’informations sur les valeurs possibles pour ce paramètre, consultez FsRtlMupGetProviderInfoFromFileObject.

Buffer

[out] Pointeur vers une mémoire tampon qui reçoit les informations du fournisseur. Les données retournées sont basées sur lede niveau spécifié. Cette mémoire tampon doit être suffisamment grande pour contenir les informations demandées par le paramètre Level.

BufferSize

[in/out] Pointeur vers une variable qui spécifie la taille, en octets, de la mémoire tampon pointée par le paramètre Tampon. Lors de l’entrée, cette variable spécifie la taille de la mémoire tampon. En sortie, cette variable reçoit le nombre d’octets écrits dans la mémoire tampon.

Valeur de retour

FltMupGetProviderInfoFromFileObject retourne STATUS_SUCCESS si l’opération réussit. Sinon, elle retourne un code NTSTATUS approprié.

Remarques

Cette routine est nécessaire pour gérer le cas des fournisseurs qui s’inscrivent à l’aide de FsRtlRegisterUncProviderEx. Le nom de l’appareil sur les objets de fichier de ce fournisseur serait \Device\Mup.

Les filtres peuvent utiliser cette routine à des fins suivantes :

• Pour pouvoir filtrer des redirecteurs spécifiques.
• Pour trouver un redirecteur qui sauvegarde un objet de fichier afin qu’il puisse contourner les bogues possibles dans les redirecteurs.

Le MUP (plusieurs fournisseurs UNC) ne peut pas être déchargé pour cet appel.

L’appelant garantit que le FileObject sera valide pendant la durée de l’appel.

Exigences

Voir aussi

FsRtlMupGetProviderInfoFromFileObject

FsRtlRegisterUncProviderEx