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

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

  • Статья

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

Синтаксис

RPC_STATUS RpcStringBindingComposeA(
  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.

Примечание

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

Требования

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

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

RpcBindingFromStringBinding

RpcBindingToStringBinding

RpcStringBindingParse

RpcStringFree