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

  • Статья

Функция RpcStringBindingCompose создает дескриптор привязки строки.

Синтаксис

RPC_STATUS RpcStringBindingCompose(
  RPC_CSTR ObjUuid,
  RPC_CSTR ProtSeq,
  RPC_CSTR NetworkAddr,
  RPC_CSTR Endpoint,
  RPC_CSTR Options,
  RPC_CSTR *StringBinding
);

Параметры

ObjUuid

Указатель на строковое представление объекта UUID, завершаемого null. Например, строка 6B29FC40-CA47-1067-B31D-00DD010662DA представляет допустимый UUID.

ProtSeq

Указатель на строковое представление последовательности протокола, завершаемого null. См. примечание.

NetworkAddr

Указатель на строковое представление сетевого адреса, завершаемого null. Формат сетевого адреса связан с последовательностью протокола. См. примечание.

Endpoint

Указатель на строковое представление конечной точки со значением NULL. Формат и содержимое конечной точки связаны с последовательностью протокола. Например, конечная точка, связанная с последовательностью протокола ncacn_np , представляет собой имя канала в формате \pipe\pipename. См. примечание.

Options

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

StringBinding

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

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

Примечание Дополнительные сведения см. в разделе Привязка строк.
 

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

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

Комментарии

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

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

Укажите значение параметра NULL или укажите пустую строку (\0) для каждой входной строки, которая не содержит данных.

Символы обратной косой черты литералов в строках языка C должны быть заключены в кавычки. Фактическая строка C для имени сервера для последовательности протокола ncacn_np отображается как \\servername, а фактическая строка C для имени канала — как \pipe\pipename.

Требования

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

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

RpcBindingFromStringBinding

RpcBindingToStringBindingBinding

RpcStringBindingParse

RpcStringFree