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

Статья
11/20/2024

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

Синтаксис

RPC_STATUS RpcBindingFromStringBindingW(
  RPC_WSTR           StringBinding,
  RPC_BINDING_HANDLE *Binding
);

Параметры

StringBinding

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

Binding

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

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

Ценность	Значение
RPC_S_OK	Вызов выполнен успешно.
RPC_S_INVALID_STRING_BINDING	Недопустимая привязка строки.
RPC_S_PROTSEQ_NOT_SUPPORTED	Последовательность протоколов не поддерживается на этом узле.
RPC_S_INVALID_RPC_PROTSEQ	Недопустимая последовательность протоколов.
RPC_S_INVALID_ENDPOINT_FORMAT	Недопустимый формат конечной точки.
RPC_S_STRING_TOO_LONG	Слишком длинная строка.
RPC_S_INVALID_NET_ADDR	Недопустимый сетевой адрес.
RPC_S_INVALID_ARG	Аргумент недопустим.
RPC_S_INVALID_NAF_ID	Недопустимый идентификатор семейства адресов сети.

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

Замечания

Функция RpcBindingFromStringBinding создает дескриптор привязки сервера из строкового представления дескриптора привязки. Параметр stringBinding не должен содержать объект UUID. В этом случае возвращаемая привязка содержит nil UUID. Если указанный параметр StringBinding не содержит поле конечной точки, возвращенный параметр привязки привязки является дескриптором привязки с частичной привязкой. Если указанный параметр StringBinding содержит поле конечной точки, то конечная точка считается хорошо известной конечной точкой. Если указанный параметр StringBinding не содержит поле адреса узла, возвращенный параметр привязки привязки ссылается на локальный узел.

Приложение создает строковую привязку путем вызова функции RpcStringBindingCompose или путем предоставления константы строки символов. Создание строковой привязки с помощью этого метода не связано с контактом с сервером. Успешное выполнение или сбой API не будет указывать на доступность сервера.

После завершения работы приложения с помощью параметра привязки приложение должно вызвать функцию RpcBindingFree, чтобы освободить память, используемую дескриптором привязки.

Заметка

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

Требования

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

См. также

RpcBindingCopy

RpcBindingFree

RpcBindingToStringBinding

RpcStringBindingCompose

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