Fonction FsRtlMupGetProviderIdFromName (ntifs.h)

Article
02/29/2024

La routine FsRtlMupGetProviderIdFromName obtient l’identificateur de fournisseur d’un redirecteur réseau inscrit auprès du fournisseur UNC multiple (MUP) à partir du nom de l’appareil du redirecteur réseau.

Syntaxe

NTSTATUS FsRtlMupGetProviderIdFromName(
  [in]  PCUNICODE_STRING pProviderName,
  [out] PULONG32         pProviderId
);

Paramètres

[in] pProviderName

Pointeur vers une chaîne Unicode qui contient le nom de l’appareil du redirecteur réseau.

[out] pProviderId

Pointeur vers une variable de type ULONG32 qui reçoit l’identificateur de fournisseur du redirecteur réseau.

Valeur retournée

La routine FsRtlMupGetProviderIdFromName retourne l’une des valeurs NTSTATUS suivantes.

Code de retour	Description
STATUS_SUCCESS	L’identificateur de fournisseur du redirecteur réseau a été retourné dans la variable vers laquelle pointe le paramètre pProviderId .
STATUS_INVALID_PARAMETER	L’un des paramètres est NULL.
STATUS_OBJECT_NAME_NOT_FOUND	Le nom du redirecteur réseau spécifié dans le paramètre pProviderName ne correspond pas au nom des fournisseurs UNC inscrits auprès du MUP.

Remarques

Un pilote de filtre de système de fichiers peut appeler la routine FsRtlMupGetProviderIdFromName pour obtenir l’identificateur de fournisseur d’un redirecteur réseau à partir du nom du redirecteur réseau. Le pilote de filtre de système de fichiers peut rapidement comparer la valeur de cet identificateur à celle d’autres identificateurs de fournisseur sans avoir à effectuer une comparaison de chaînes.

La valeur de l’identificateur de fournisseur pour un redirecteur réseau particulier reste la même si le redirecteur réseau est déchargé du système, puis rechargé dans le système.

Pour obtenir l’identificateur de fournisseur d’un redirecteur réseau à partir d’un objet de fichier, un pilote de filtre de système de fichiers peut appeler la routine FsRtlMupGetProviderInfoFromFileObject .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	La fonction FsRtlMupGetProviderIdFromName est Windows Vista
Plateforme cible	Universal
En-tête	ntifs.h (inclure Ntifs.h)
Bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL

Voir aussi

FsRtlMupGetProviderInfoFromFileObject

Partager via