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

  • Статья

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

Синтаксис

RPC_STATUS RpcBindingToStringBinding(
  RPC_BINDING_HANDLE Binding,
  RPC_CSTR           *StringBinding
);

Параметры

Binding

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

StringBinding

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

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

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

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

Комментарии

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

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

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

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

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

Требования

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

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

RpcBindingFromStringBinding

RpcStringBindingParse

RpcStringFree