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

  • Статья
  • Чтение занимает 2 мин

Функция 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 (include Rpc.h)
Библиотека Rpcrt4.lib
DLL Rpcrt4.dll

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

RpcBindingFromStringBindingBinding

RpcBindingToStringBindingBinding

RpcStringBindingParse

RpcStringFree