FsRtlMupGetProviderIdFromName 函数 (ntifs.h)

FsRtlMupGetProviderIdFromName 例程从网络重定向器的设备名称获取向多个 UNC 提供程序注册的网络重定向程序的提供程序标识符， (MUP) 。

语法

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

[in] pProviderName

指向包含网络重定向程序设备名称的 Unicode 字符串的指针。

[out] pProviderId

指向ULONG32类型的变量的指针，该变量接收网络重定向程序的提供程序标识符。

FsRtlMupGetProviderIdFromName 例程返回以下 NTSTATUS 值之一。

返回代码	说明
STATUS_SUCCESS	网络重定向程序的提供程序标识符已成功在 pProviderId 参数所指向的变量中返回。
STATUS_INVALID_PARAMETER	其中一个参数为 NULL。
STATUS_OBJECT_NAME_NOT_FOUND	pProviderName 参数中指定的网络重定向程序的名称与注册到 MUP 的任何 UNC 提供程序的名称不匹配。

文件系统筛选器驱动程序可以调用 FsRtlMupGetProviderIdFromName 例程，以从网络重定向程序的名称获取网络重定向程序的提供程序标识符。文件系统筛选器驱动程序可以快速将此标识符的值与其他提供程序标识符的值进行比较，而无需执行字符串比较。

如果从系统卸载网络重定向程序，然后重新加载回系统，则特定网络重定向程序的提供程序标识符值保持不变。

若要从文件对象获取网络重定向程序的提供程序标识符，文件系统筛选器驱动程序可以调用 FsRtlMupGetProviderInfoFromFileObject 例程。

要求	值
最低受支持的客户端	FsRtlMupGetProviderIdFromName 函数为 Windows Vista
目标平台	通用
标头	ntifs.h (包括 Ntifs.h)
Library	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL