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

Статья
08/25/2023

Функция RpcBindingFromStringBinding возвращает дескриптор привязки из строкового представления дескриптора привязки.

Синтаксис

RPC_STATUS RpcBindingFromStringBindingW(
  RPC_WSTR           StringBinding,
  RPC_BINDING_HANDLE *Binding
);

Параметры

StringBinding

Указатель на строковое представление дескриптора привязки.

Binding

Возвращает указатель на дескриптор привязки сервера.

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

Значение	Значение
RPC_S_OK	Вызов выполнен успешно.
RPC_S_INVALID_STRING_BINDING	Недопустимая привязка строки.
RPC_S_PROTSEQ_NOT_SUPPORTED	Последовательность протоколов не поддерживается на этом узле.
RPC_S_INVALID_RPC_PROTSEQ	Последовательность протоколов недопустимая.
RPC_S_INVALID_ENDPOINT_FORMAT	Недопустимый формат конечной точки.
RPC_S_STRING_TOO_LONG	Слишком длинная строка.
RPC_S_INVALID_NET_ADDR	Недопустимый сетевой адрес.
RPC_S_INVALID_ARG	Аргумент недопустим.
RPC_S_INVALID_NAF_ID	Недопустимый идентификатор семейства сетевых адресов.

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

Функция RpcBindingFromStringBinding создает дескриптор привязки сервера из строкового представления дескриптора привязки. Параметр StringBinding не обязательно должен содержать объект UUID. В этом случае возвращаемая привязка содержит nil UUID. Если предоставленный параметр StringBinding не содержит поля конечной точки, возвращаемый параметр Binding является дескриптором привязки с частичной привязкой. Если предоставленный параметр StringBinding содержит поле конечной точки, конечная точка считается известной конечной точкой. Если предоставленный параметр StringBinding не содержит поля адреса узла, возвращенный параметр Binding ссылается на локальный узел.

Приложение создает строковую привязку, вызывая функцию RpcStringBindingCompose или предоставляя символьную строковую константу. Создание строковой привязки этим методом не требует контакта с сервером. Успех или сбой API не указывает на доступность сервера.

После завершения работы приложения с помощью параметра Binding приложение должно вызвать функцию RpcBindingFree , чтобы освободить память, используемую дескриптором привязки.

Примечание

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

Требования


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

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

RpcBindingCopy

RpcBindingFree

RpcBindingToStringBinding

RpcStringBindingCompose

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