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

Статья
11/20/2024

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

Синтаксис

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

Параметры

StringBinding

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

ObjUuid

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

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

Заметка

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

Требования

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

См. также

RpcBindingFromStringBinding

RpcBindingToStringBinding

RpcStringBindingCompose

RpcStringFree

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