FsRtlMupGetProviderIdFromName-Funktion (ntifs.h)
Die FsRtlMupGetProviderIdFromName Routine ruft den Anbieterbezeichner eines Netzwerkumleitungsmoduls ab, der mit dem mehrfachen UNC-Anbieter (MUP) vom Gerätenamen des Netzwerkumleitungsanbieters registriert ist.
Syntax
NTSTATUS FsRtlMupGetProviderIdFromName(
[in] PCUNICODE_STRING pProviderName,
[out] PULONG32 pProviderId
);
Parameter
[in] pProviderName
Ein Zeiger auf eine Unicode-Zeichenfolge, die den Gerätenamen des Netzwerkumleitungs enthält.
[out] pProviderId
Ein Zeiger auf eine ULONG32 Typvariable, die den Anbieterbezeichner des Netzwerkumleitungsmoduls empfängt.
Rückgabewert
Die FsRtlMupGetProviderIdFromName Routine gibt einen der folgenden NTSTATUS-Werte zurück.
| Rückgabecode | Beschreibung |
|---|---|
|
Der Anbieterbezeichner des Netzwerkumleitungsmoduls wurde erfolgreich in der Variablen zurückgegeben, auf die der pProviderId -Parameter verweist. |
|
Einer der Parameter ist NULL-. |
|
Der Name des im pProviderName Parameters angegebenen Netzwerkumleitung stimmt nicht mit dem Namen eines der UNC-Anbieter überein, die bei der MUP registriert sind. |
Bemerkungen
Ein Dateisystemfiltertreiber kann die FsRtlMupGetProviderIdFromName Routine aufrufen, um den Anbieterbezeichner eines Netzwerkumleitungsanbieters vom Namen des Netzwerkumleitungsanbieters abzurufen. Der Dateisystemfiltertreiber kann den Wert dieses Bezeichners schnell mit dem Wert anderer Anbieterbezeichner vergleichen, ohne einen Zeichenfolgenvergleich durchführen zu müssen.
Der Wert des Anbieterbezeichners für einen bestimmten Netzwerkumleitungsanbieter bleibt gleich, wenn der Netzwerkumleitungsmodul aus dem System entladen und dann wieder in das System geladen wird.
Um den Anbieterbezeichner eines Netzwerkumleitungs aus einem Dateiobjekt abzurufen, kann ein Dateisystemfiltertreiber die FsRtlMupGetProviderInfoFromFileObject Routine aufrufen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Die FsRtlMupGetProviderIdFromName-Funktion ist Windows Vista |
| Zielplattform- | Universal |
| Header- | ntifs.h (einschließlich Ntifs.h) |
| Library | NtosKrnl.lib |
| DLL- | NtosKrnl.exe |
| IRQL- | <= APC_LEVEL |