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

Статья
08/25/2023

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

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

Синтаксис

RPC_STATUS RpcNsBindingInqEntryName(
  RPC_BINDING_HANDLE Binding,
  unsigned long      EntryNameSyntax,
  RPC_CSTR           *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.

Требования

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