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

Статья
11/20/2024

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

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

Укажите значение 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 возвращает имя имени записи службы -базы данных, из которой поступил дескриптор привязки, совместимый с клиентом.

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

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

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

Заметка

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

Требования

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

См. также

RpcBindingFromStringBinding

RpcNsBindingImportNext

RpcNsBindingLookupNext

RpcNsBindingSelect

RpcStringFree

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