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

Статья
11/20/2024

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

Синтаксис

RPC_STATUS RpcStringBindingComposeW(
  RPC_WSTR ObjUuid,
  RPC_WSTR ProtSeq,
  RPC_WSTR NetworkAddr,
  RPC_WSTR Endpoint,
  RPC_WSTR Options,
  RPC_WSTR *StringBinding
);

Параметры

ObjUuid

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

ProtSeq

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

NetworkAddr

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

Endpoint

Указатель на null-завершенное строковое представление конечной точки. Формат конечной точки и содержимое связаны с последовательностью протоколов. Например, конечная точка, связанная с последовательностью протоколов, ncacn_np является именем канала в формате \pipe\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\pipe\pipename.

Заметка

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

Требования

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

См. также

RpcBindingFromStringBinding

RpcBindingToStringBinding

RpcStringBindingParse

RpcStringFree

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