Функция RpcNsBindingUnexportPnPA (rpcnsi.h)

Статья
11/20/2024

Функция RpcNsBindingUnexportPnP удаляет дескриптор привязки для интерфейсов и объектов Plug and Play из записи в базе данных службы имен.

Примечание Эта функция не поддерживается в windows Vista и более поздних операционных системах.

Синтаксис

RPC_STATUS RpcNsBindingUnexportPnPA(
  unsigned long EntryNameSyntax,
  RPC_CSTR      EntryName,
  RPC_IF_HANDLE IfSpec,
  UUID_VECTOR   *ObjectVector
);

Параметры

EntryNameSyntax

Синтаксис EntryName.

Чтобы использовать синтаксис, указанный в записи значения реестра HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultSyntax, укажите значение RPC_C_NS_SYNTAX_DEFAULT.

EntryName

Указатель на имя записи, из которого удаляются дескрипторы привязки и идентификаторы UUID объектов.

IfSpec

Спецификация интерфейса для дескрипторов привязки, которые необходимо удалить из базы данных службы имен. Значение параметра NULL указывает, что не следует откружать какие-либо дескрипторы привязки (только идентификаторы UUID объекта должны быть не включены).

ObjectVector

Указатель на вектор UUID объекта, который сервер больше не хочет предложить. Приложение создает этот вектор. Значение NULL указывает, что не существует идентификаторов UUID объекта для неэкспорта (только дескриптор привязки не требуется).

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

Ценность	Значение
RPC_S_OK	Вызов выполнен успешно.
RPC_S_INVALID_VERS_OPTION	Недопустимый параметр версии.
RPC_S_INVALID_NAME_SYNTAX	Недопустимый синтаксис имени.
RPC_S_UNSUPPORTED_NAME_SYNTAX	Синтаксис имени не поддерживается.
RPC_S_INCOMPLETE_NAME	Имя является неполным.
RPC_S_ENTRY_NOT_FOUND	Запись службы имен не найдена.
RPC_S_NAME_SERVICE_UNAVAILABLE	Служба имен недоступна.
RPC_S_INTERFACE_NOT_FOUND	Интерфейс не найден.
RPC_S_NOT_ALL_OBJS_UNEXPORTED	Не все объекты не поддерживаются.

Примечание Список допустимых кодов ошибок см. в разделе возвращаемых значений RPC.

Замечания

Функция RpcNsBindingUnexportPnP позволяет серверу приложению удалить дескриптора привязки и идентификаторы UUID ресурсов, совместимых с Plug and Play, из записи базы данных службы имен. Серверное приложение может не использовать указанный интерфейс и объекты в одном вызове RpcNsBindingUnexportPnP, или его можно отменить отдельно. Только дескриптор привязки, соответствующий интерфейсу UUID, и номера версий основного и дополнительного интерфейса, найденные в параметре IfSpec, не поддерживаются.

Заметка

Заголовок rpcnsi.h определяет RpcNsBindingUnexportPnP как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	rpcnsi.h (include Rpc.h)
библиотеки	Rpcns4.lib
DLL	Rpcns4.dll

См. также

RpcNsBindingExportPnP

RpcNsBindingUnexport

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