Функция RpcNsBindingExportPnPA (rpcnsi.h)
Функция RpcNsBindingExportPnP устанавливает запись базы данных службы имен с несколькими дескрипторами привязки и несколькими объектами для сервера, поддерживающего Plug and Play.
Синтаксис
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 объекта (экспортируются только дескрипторы привязки).
Возвращаемое значение
Значение | Значение |
---|---|
|
Вызов выполнен успешно. |
|
Экспортировать нечего. |
|
Недопустимый дескриптор привязки. |
|
Это был неправильный тип привязки для операции. |
|
Недопустимый синтаксис имени. |
|
Синтаксис имени не поддерживается. |
|
Имя является неполным. |
|
Нет привилегий для операции службы имен. |
|
Служба имен недоступна. |
Комментарии
Функция RpcNsBindingExportPnP позволяет серверным приложениям публично предлагать интерфейс в базе данных службы имен, который поддерживает привязки Plug and Play для использования любым клиентским приложением.
Обратите внимание, что серверное приложение не должно явно предоставлять вектор привязки при экспорте привязок Plug and Play. Привязки автоматически обновляются при изменении привязок из-за события Plug and Play.
Примечание
Заголовок rpcnsi.h определяет RpcNsBindingExportPnP в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.
Требования
Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
Целевая платформа | Windows |
Header | rpcnsi.h (включая Rpc.h) |
Библиотека | Rpcns4.lib |
DLL | Rpcns4.dll |
См. также раздел
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделеОтправить и просмотреть отзыв по