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

Статья
11/20/2024

Функция RpcNsBindingExportPnP устанавливает запись базы данных name-service с несколькими дескрипторами привязки и несколькими объектами для сервера, поддерживающего Plug and Play.

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

Синтаксис

RPC_STATUS RpcNsBindingExportPnPA(
  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 объектов. Нельзя указать пустую или пустую строку.

Чтобы использовать имя записи, указанное в записи значения реестра HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultEntry, укажите пустой указатель или пустую строку. В этом случае параметр EntryNameSyntax игнорируется, а библиотека времени выполнения использует синтаксис по умолчанию.

IfSpec

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

ObjectVector

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

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

Ценность	Значение
RPC_S_OK	Вызов выполнен успешно.
RPC_S_NOTHING_TO_EXPORT	Не было ничего, чтобы экспортировать.
RPC_S_INVALID_BINDING	Дескриптор привязки недопустим.
RPC_S_WRONG_KIND_OF_BINDING	Это был неправильный вид привязки для операции.
RPC_S_INVALID_NAME_SYNTAX	Недопустимый синтаксис имени.
RPC_S_UNSUPPORTED_NAME_SYNTAX	Синтаксис имени не поддерживается.
RPC_S_INCOMPLETE_NAME	Имя является неполным.
RPC_S_NO_NS_PRIVILEGE	Нет привилегий для операции name-service.
RPC_S_NAME_SERVICE_UNAVAILABLE	Служба имен недоступна.

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

Замечания

Функция RpcNsBindingExportPnP позволяет серверу приложению публично предлагать интерфейс в базе данных службы имен, которая поддерживает привязки Plug and Play для использования любым клиентским приложением.

Обратите внимание, что серверное приложение не должно явно предоставлять вектор привязки при экспорте привязок Plug and Play. Привязки автоматически обновляются при изменении привязок из-за события Plug and Play.

Заметка

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

Требования

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

См. также

RpcNsBindingExport

RpcNsBindingUnexportPnP

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