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


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

Функция 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.
 

Комментарии

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

Библиотека времени выполнения 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

См. также раздел

RpcBindingFromStringBinding

RpcNsBindingImportNext

RpcNsBindingLookupNext

RpcNsBindingSelect

RpcStringFree