Функция RpcNsBindingInqEntryNameW (rpcdce.h)

Статья
08/25/2023

Функция RpcNsBindingInqEntryName возвращает имя записи, из которой поступил дескриптор привязки.

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

Синтаксис

RPC_STATUS RpcNsBindingInqEntryNameW(
  RPC_BINDING_HANDLE Binding,
  unsigned long      EntryNameSyntax,
  RPC_WSTR           *EntryName
);

Параметры

Binding

Дескриптор привязки, для которого возвращается имя записи базы данных службы.

EntryNameSyntax

Синтаксис, используемый в EntryName.

Использование синтаксиса, указанного в записи значения реестра

HKEY_LOCAL_MACHINE\Software\Microsoft\Rpc\NameService\DefaultSyntaxукажите значение RPC_C_NS_SYNTAX_DEFAULT.

EntryName

Возвращает адрес указателя на имя записи базы данных службы имен, в которой была найдена привязка .

Укажите значение NULL, чтобы запретить RpcNsBindingInqEntryName возвращать параметр EntryName . В этом случае приложение не вызывает функцию RpcStringFree .

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

Значение	Значение
RPC_S_OK	Вызов выполнен успешно.
RPC_S_INVALID_BINDING	Недопустимый дескриптор привязки.
RPC_S_NO_ENTRY_NAME	Имя записи для привязки отсутствует.
RPC_S_INVALID_NAME_SYNTAX	Недопустимый синтаксис имени.
RPC_S_UNSUPPORTED_NAME_SYNTAX	Синтаксис имени не поддерживается.
RPC_S_INCOMPLETE_NAME	Имя является неполным.

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

Библиотека времени выполнения RPC выделяет память для строки, возвращаемой в параметре EntryName . Приложение отвечает за вызов функции RpcStringFree для освобождения памяти.

Имя записи связано только с дескрипторами привязки, возвращаемыми функциями RpcNsBindingImportNext, RpcNsBindingLookupNext и RpcNsBindingSelect .

Если дескриптор привязки, указанный в параметре Binding , не был возвращен из записи базы данных службы имен (например, если дескриптор привязки был создан путем вызова RpcBindingFromStringBindingBindingInqEntryName), RpcNsBindingInqEntryName возвращает пустую строку ("\0") и код состояния RPC_S_NO_ENTRY_NAME.

Примечание

Заголовок rpcdce.h определяет RpcNsBindingInqEntryName в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования


Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	rpcdce.h (включая Rpc.h)
Библиотека	Rpcrt4.lib
DLL	Rpcrt4.dll