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

  • Статья

Подпрограмма 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 (включая Ntifs.h)
Библиотека NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

См. также раздел

FsRtlMupGetProviderInfoFromFileObject