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

  • Статья

Функция RpcStringBindingParse возвращает часть UUID объекта и части адреса привязки строки в виде отдельных строк. Приложение вызывает RpcStringBindingParse для анализа строкового представления дескриптора привязки в полях компонента. Функция RpcStringBindingParse возвращает часть UUID объекта и части адреса привязки строки в виде отдельных строк.

Синтаксис

RPC_STATUS RpcStringBindingParse(
  RPC_CSTR StringBinding,
  RPC_CSTR *ObjUuid,
  RPC_CSTR *Protseq,
  RPC_CSTR *NetworkAddr,
  RPC_CSTR *Endpoint,
  RPC_CSTR *NetworkOptions
);

Параметры

StringBinding

Указатель на строковое представление привязки, завершающееся значением NULL.

ObjUuid

Возвращает указатель на указатель на строковое представление объекта UUID, завершающееся null.

Укажите значение NULL , чтобы запретить RpcStringBindingParse возвращать параметр ObjectUuid . В этом случае приложение не вызывает RpcStringFree.

Protseq

Возвращает указатель на указатель на строковое представление последовательности протокола, завершающееся значением NULL. Список поддерживаемых последовательностей протоколов Microsoft RPC см. в разделе Привязка строк.

Укажите значение NULL , чтобы запретить RpcStringBindingParse возвращать параметр ProtSeq . В этом случае приложение не вызывает RpcStringFree.

NetworkAddr

Возвращает указатель на указатель на строковое представление сетевого адреса, завершающееся null. Укажите значение NULL , чтобы запретить RpcStringBindingParse возвращать параметр NetworkAddr . В этом случае приложение не вызывает RpcStringFree.

Endpoint

Возвращает указатель на указатель на строковое представление конечной точки, завершающееся null. Укажите значение NULL , чтобы запретить RpcStringBindingParse возвращать параметр EndPoint . В этом случае приложение не вызывает RpcStringFree.

NetworkOptions

Возвращает указатель на указатель на строковое представление параметров сети, завершающееся значением NULL.

Укажите значение NULL , чтобы запретить RpcStringBindingParse возвращать параметр NetworkOptions . В этом случае приложение не вызывает RpcStringFree.

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

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

Комментарии

Приложение вызывает подпрограмму RpcStringBindingParse для анализа строкового представления дескриптора привязки в полях компонента.

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

Если какое-либо поле параметра StringBinding пустое, RpcStringBindingParse возвращает пустую строку (\0) в соответствующем выходном параметре.

Примечание Чтобы запросить адрес клиента, приложение начинается с вызова функции RpcBindingServerFromClient, чтобы получить частично привязанный дескриптор привязки сервера. Дескриптор привязки сервера можно использовать для получения привязки строки путем вызова RpcBindingToStringBindingBinding. Затем сервер может вызвать RpcStringBindingParse, чтобы извлечь сетевой адрес клиента из привязки строки.
 

Требования

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

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

RpcBindingFromStringBinding

RpcBindingToStringBindingBinding

RpcStringBindingCompose

RpcStringFree