FsRtlMupGetProviderIdFromName, fonction (ntifs.h)
La routine FsRtlMupGetProviderIdFromName obtient l’identificateur du fournisseur d’un redirecteur réseau inscrit auprès du multiple fournisseur UNC (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 ULONG32 typée qui reçoit l’identificateur du fournisseur du redirecteur réseau.
Valeur de retour
La routine FsRtlMupGetProviderIdFromName retourne l’une des valeurs NTSTATUS suivantes.
| Retourner le code | Description |
|---|---|
|
L’identificateur du fournisseur du redirecteur réseau a été retourné avec succès dans la variable pointée par le paramètre pProviderId . |
|
L’un des paramètres est NULL . |
|
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 du fournisseur d’un redirecteur réseau à partir du nom du redirecteur réseau. Le pilote de filtre du système de fichiers peut rapidement comparer la valeur de cet identificateur à la valeur 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é à partir 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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | La fonction FsRtlMupGetProviderIdFromName est Windows Vista |
| plateforme cible | Universel |
| d’en-tête | ntifs.h (include Ntifs.h) |
| bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |