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