Функция RpcSsDetextClientContext (rpcndr.h)

Функция RpcSsDesphereClientContext уничтожает дескриптор контекста, который больше не нужен клиенту, без обращения к серверу.

Синтаксис

void RpcSsDestroyClientContext(
  void **ContextHandle
);

Параметры

ContextHandle

Дескриптор контекста, который необходимо уничтожить. Дескриптор имеет значение NULL перед возвратом RpcSsDe диффератиентClientContext .

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

RpcSsDetextClientContext не имеет возвращаемого значения.

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

 

Комментарии

Клиентским приложением используется RpcSsDesphereClientContext для освобождения ресурсов памяти, используемых для поддержания дескриптора контекста на клиенте. Эта функция используется, когда ContextHandle больше недействителен, например, если произошел сбой связи и сервер больше недоступен. Дескриптор контекста имеет значение NULL. Функция RpcSsDetextClientContext предоставляет те же функциональные возможности, что и функция RpcSmDetextClientContext . Эта функция не вызывает процесс запуска дескриптора контекста сервера.

Не используйте RpcSsDetextClientContext для замены серверной функции, которая закрывает дескриптор контекста.

Функция RpcSsDetextClientContext может вызвать исключение RPC_X_SS_CONTEXT_MISMATCH, если переданный ей дескриптор контекста недопустим. Приложения никогда не должны передавать в эту функцию недопустимый дескриптор контекста. Если возникает исключение, оно указывает на ошибку в вызывающем коде, поэтому его следует исследовать и исправить.

Требования

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

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

RpcBindingReset

RpcSmDe со временемClientContext