Функция FsRtlMupGetProviderIdFromName (ntifs.h)

Статья
12/22/2024

Подпрограмма FsRtlMupGetProviderIdFromName получает идентификатор поставщика сетевого перенаправления, зарегистрированного в нескольких поставщиках UNC (MUP) из имени устройства сетевого перенаправления.

Синтаксис

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

Параметры

[in] pProviderName

Указатель на строку Юникода, содержащую имя устройства сетевого перенаправления.

[out] pProviderId

Указатель на переменную типа ULONG32, которая получает идентификатор поставщика сетевого перенаправления.

Возвращаемое значение

Подпрограмма FsRtlMupGetProviderIdFromName возвращает одно из следующих значений NTSTATUS.

Возвращаемый код	Описание
STATUS_SUCCESS	Идентификатор поставщика сетевого перенаправления был успешно возвращен в переменной, на которую указывает параметр pProviderId .
STATUS_INVALID_PARAMETER	Одним из параметров является NULL.
STATUS_OBJECT_NAME_NOT_FOUND	Имя перенаправления сети, указанного в параметре pProviderName , не соответствует имени любого из поставщиков UNC, зарегистрированных в MUP.

Замечания

Драйвер фильтра файловой системы может вызвать процедуру FsRtlMupGetProviderIdFromName, чтобы получить идентификатор поставщика сетевого перенаправления от имени сетевого перенаправления. Драйвер фильтра файловой системы может быстро сравнить значение этого идентификатора со значением других идентификаторов поставщика, не выполняя сравнение строк.

Значение идентификатора поставщика для определенного сетевого перенаправления остается неизменным, если сетевой перенаправление выгрузится из системы, а затем перезагрузится обратно в систему.

Чтобы получить идентификатор поставщика сетевого перенаправления из объекта файла, драйвер фильтра файловой системы может вызвать подпрограмму FsRtlMupGetProviderInfoFromFileObject.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Функция FsRtlMupGetProviderIdFromName — Windows Vista
целевая платформа	Всеобщий
заголовка	ntifs.h (include Ntifs.h)
библиотеки	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL

См. также

FsRtlMupGetProviderInfoFromFileObject

Поделиться через