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

  • Статья

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

Синтаксис

RPC_STATUS RpcBindingFromStringBinding(
  RPC_CSTR           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. В этом случае возвращаемая привязка содержит UUID nil. Если предоставленный параметр StringBinding не содержит поле конечной точки, возвращенный параметр Binding является дескриптором привязки с частичной привязкой. Если предоставленный параметр StringBinding содержит поле конечной точки, конечная точка считается хорошо известной конечной точкой. Если указанный параметр StringBinding не содержит поле адреса узла, возвращаемый параметр Binding ссылается на локальный узел.

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

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

Требования

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

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

RpcBindingCopy

RpcBindingFree

RpcBindingToStringBindingBinding

RpcStringBindingCompose