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

Статья
11/20/2024

Функция RpcNetworkIsProtseqValid указывает, поддерживается ли указанная последовательность протоколов как библиотекой времени выполнения RPC, так и операционной системой. Серверные приложения часто используют RpcNetworkInqProtseqs.

Синтаксис

RPC_STATUS RpcNetworkIsProtseqValidA(
  RPC_CSTR Protseq
);

Параметры

Protseq

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

Если параметр Protseq не является допустимой строкой последовательности протоколов, RpcNetworkIsProtseqValid возвращает RPC_S_INVALID_RPC_PROTSEQ.

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

Ценность	Значение
RPC_S_OK	Вызов выполнен успешно.; Поддерживается последовательность протоколов
RPC_S_PROTSEQ_NOT_SUPPORTED	Последовательность протоколов не поддерживается на этом узле.
RPC_S_INVALID_RPC_PROTSEQ	Недопустимая последовательность протоколов.

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

Замечания

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

Последовательность протоколов допустима, если библиотека времени выполнения RPC и операционная система поддерживают указанные протоколы. Список поддерживаемых последовательностей протоколов Microsoft RPC см. в строковой привязке. Приложение вызывает RpcNetworkInqProtseqs, чтобы просмотреть все поддерживаемые последовательности протоколов.

Заметка

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

Требования

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

См. также

RpcNetworkInqProtseqs

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