FsRtlMupGetProviderIdFromName 函式 (ntifs.h)
FsRtlMupGetProviderIdFromName 例程會從網路重新導向器的裝置名稱取得向多個 UNC 提供者註冊的網路重新導向器提供者標識符， (MUP) 。
語法
NTSTATUS FsRtlMupGetProviderIdFromName(
[in] PCUNICODE_STRING pProviderName,
[out] PULONG32 pProviderId
);
參數
[in] pProviderName
Unicode 字串的指標，其中包含網路重新導向器的裝置名稱。
[out] pProviderId
接收網路重新導向器提供者標識碼之ULONG32型別變數的指標。
傳回值
FsRtlMupGetProviderIdFromName 例程會傳回下列其中一個 NTSTATUS 值。
| 傳回碼 | Description |
|---|---|
|
網路重新導向器的提供者標識碼已成功在 pProviderId 參數所指向的變數中傳回。 |
|
其中一個參數是 NULL。 |
|
pProviderName 參數中指定的網路重新導向器名稱不符合向 MUP 註冊的任何 UNC 提供者名稱。 |
備註
文件系統篩選驅動程式可以呼叫 FsRtlMupGetProviderIdFromName 例程，從網路重新導向器的名稱取得網路重新導向器的提供者識別符。 文件系統篩選驅動程式可以快速比較此標識碼的值與其他提供者標識碼的值，而不需要進行字串比較。
如果從系統卸除網路重新導向器，然後重載回系統，則特定網路重新導向器的提供者標識碼值會維持不變。
若要從檔案物件取得網路重新導向器的提供者標識符，文件系統篩選驅動程式可以呼叫 FsRtlMupGetProviderInfoFromFileObject 例程。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | FsRtlMupGetProviderIdFromName 函式為 Windows Vista |
| 目標平台 | Universal |
| 標頭 | ntifs.h (包含 Ntifs.h) |
| 程式庫 | NtosKrnl.lib |
| Dll | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |