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

Статья
08/25/2023

Функция RpcSsDontSerializeContext отключает сериализацию во время выполнения нескольких вызовов, отправляемых подпрограммам диспетчера сервера в одном дескрипторе контекста. Использовать эту функцию не рекомендуется. Вместо этого разработчикам следует использовать сериализацию обработчика содержимого в смешанном режиме. В разделе См. также приведены ссылки на более подходящие функции.

Синтаксис

void RpcSsDontSerializeContext();

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

None

Remarks

Функция RpcSsDontSerializeContext предотвращает выполнение этой службы сериализации во время выполнения, позволяя отправлять несколько вызовов для заданного дескриптора контекста. Вызов этой функции не отключает сериализацию полностью— при выполнении контекста подпрограмма запуска контекста не будет выполняться до тех пор, пока не будут завершены все незавершенные клиентские запросы. Изменения состояния дескриптора контекста, включая обычно освобождение дескриптора контекста, должны продолжать сериализоваться.

Если распределенное приложение вызывает функцию RpcSsDontSerializeContext , этот вызов рекомендуется выполнить до того, как серверная программа начнет обрабатывать удаленные вызовы процедур.

Примечание Как правило, среда выполнения RPC сериализует вызовы одного и того же дескриптора контекста, отправляемые подпрограммам диспетчера сервера. Дескрипторы контекста поддерживаются для каждого клиента и обычно представляют состояние на стороне сервера. Это означает, что диспетчер сервера не должен защищаться от изменения контекста другим потоком от того же клиента или от запуска контекста во время отправки вызова.

Примечание После вызова функция RpcSsDontSerializeContext не может быть восстановлена в течение всего процесса.

Требования


Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	rpcdce.h
Библиотека	Rpcrt4.lib
DLL	Rpcrt4.dll

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

Многопоточные клиенты и дескрипторы контекста

RpcSsContextLockExclusive

RpcSsContextLockShared

Подпрограмма запуска контекста сервера

context_handle_noserialize

context_handle_serialize

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