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

Статья
08/25/2023

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

Синтаксис

RPC_STATUS RpcStringBindingComposeW(
  RPC_WSTR ObjUuid,
  RPC_WSTR ProtSeq,
  RPC_WSTR NetworkAddr,
  RPC_WSTR Endpoint,
  RPC_WSTR Options,
  RPC_WSTR *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 или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

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

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

RpcBindingFromStringBinding

RpcBindingToStringBindingBinding

RpcStringBindingParse

RpcStringFree

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