FsRtlMupGetProviderIdFromName 函式 (ntifs.h)

FsRtlMupGetProviderIdFromName 例程會從網路重新導向器的裝置名稱取得向多個 UNC 提供者註冊的網路重新導向器提供者標識符， (MUP) 。

語法

NTSTATUS FsRtlMupGetProviderIdFromName(
  [in]  PCUNICODE_STRING pProviderName,
  [out] PULONG32         pProviderId
);

[in] pProviderName

Unicode 字串的指標，其中包含網路重新導向器的裝置名稱。

[out] pProviderId

接收網路重新導向器提供者標識碼之ULONG32型別變數的指標。

FsRtlMupGetProviderIdFromName 例程會傳回下列其中一個 NTSTATUS 值。

傳回碼	Description
STATUS_SUCCESS	網路重新導向器的提供者標識碼已成功在 pProviderId 參數所指向的變數中傳回。
STATUS_INVALID_PARAMETER	其中一個參數是 NULL。
STATUS_OBJECT_NAME_NOT_FOUND	pProviderName 參數中指定的網路重新導向器名稱不符合向 MUP 註冊的任何 UNC 提供者名稱。

文件系統篩選驅動程式可以呼叫 FsRtlMupGetProviderIdFromName 例程，從網路重新導向器的名稱取得網路重新導向器的提供者識別符。文件系統篩選驅動程式可以快速比較此標識碼的值與其他提供者標識碼的值，而不需要進行字串比較。

如果從系統卸除網路重新導向器，然後重載回系統，則特定網路重新導向器的提供者標識碼值會維持不變。

若要從檔案物件取得網路重新導向器的提供者標識符，文件系統篩選驅動程式可以呼叫 FsRtlMupGetProviderInfoFromFileObject 例程。

需求	值
最低支援的用戶端	FsRtlMupGetProviderIdFromName 函式為 Windows Vista
目標平台	Universal
標頭	ntifs.h (包含 Ntifs.h)
程式庫	NtosKrnl.lib
Dll	NtosKrnl.exe
IRQL	<= APC_LEVEL