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

Статья
11/20/2024

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

Синтаксис

RPC_STATUS RpcBindingToStringBindingA(
  RPC_BINDING_HANDLE Binding,
  RPC_CSTR           *StringBinding
);

Параметры

Binding

Дескриптор привязки клиента или сервера для преобразования в строковое представление дескриптора привязки.

StringBinding

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

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

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

Ценность	Значение
RPC_S_OK	Вызов выполнен успешно.
RPC_S_INVALID_BINDING	Дескриптор привязки недопустим.

Примечание Список допустимых кодов ошибок см. в разделе возвращаемых значений RPC.

Замечания

Функция R RpcBindingToStringBinding преобразует дескриптор привязки клиента или сервера в строковое представление.

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

Если дескриптор привязки в параметр е привязки содержит объект nil UUID, поле объекта UUID не включается в возвращаемую строку.

Чтобы проанализировать возвращаемый параметр StringBinding, вызовите функцию RpcStringBindingParse.

Примечание Для запроса адреса клиента приложение начинается с вызова функции RpcBindingServerFromClient, чтобы получить дескриптор привязки сервера с частичной привязкой. Дескриптор привязки сервера можно использовать для получения строковой привязки путем вызова RpcBindingToStringBinding. Затем сервер может вызвать RpcStringBindingParse, чтобы извлечь сетевой адрес клиента из строковой привязки.

Заметка

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

Требования

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

См. также

RpcBindingFromStringBinding

RpcStringBindingParse

RpcStringFree

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