FsRtlMupGetProviderIdFromName-Funktion (ntifs.h)
Die FsRtlMupGetProviderIdFromName-Routine ruft den Anbieterbezeichner eines Netzwerkumleitungsanbieters ab, der beim mehrfachen UNC-Anbieter (MUP) registriert ist, aus dem Gerätenamen der Netzwerkumleitung.
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 typisierte Variable, die den Anbieterbezeichner des Netzwerkumleitungsanbieters empfängt.
Rückgabewert
Die FsRtlMupGetProviderIdFromName-Routine gibt einen der folgenden NTSTATUS-Werte zurück.
| Rückgabecode | Beschreibung |
|---|---|
|
Der Anbieterbezeichner des Netzwerkumleitungs wurde erfolgreich in der Variablen zurückgegeben, auf die vom pProviderId-Parameter verwiesen wird. |
|
Einer der Parameter ist NULL. |
|
Der Name des im pProviderName-Parameter angegebenen Netzwerkumleitungsmoduls stimmt nicht mit dem Namen eines der UNC-Anbieter überein, die bei der MUP registriert sind. |
Hinweise
Ein Dateisystemfiltertreiber kann die FsRtlMupGetProviderIdFromName-Routine aufrufen, um den Anbieterbezeichner eines Netzwerkumleitungs aus dem Namen der Netzwerkumleitung 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 Netzwerkumleitungsor bleibt gleich, wenn der Netzwerkumleitungsor 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 |
|---|---|
| Unterstützte Mindestversion (Client) | Die FsRtlMupGetProviderIdFromName-Funktion ist Windows Vista. |
| Zielplattform | Universell |
| Header | ntifs.h (include Ntifs.h) |
| Bibliothek | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |