WsRevokeSecurityContext function (webservices.h)

Revokes a security context. Can only be called on the server side. Further requests using this security context will fail and a fault will be sent to the client.

This function can be used when the server knows that no more messages are coming and does not want to wait for the client or the context timeouts to trigger the reclaiming of resources, or when the server wants to engage in active context management.

Syntax

HRESULT WsRevokeSecurityContext(
  [in]           WS_SECURITY_CONTEXT *securityContext,
  [in, optional] WS_ERROR            *error
);

Parameters

[in] securityContext

The security context to be revoked.

[in, optional] error

Specifies where additional error information should be stored if the function fails.

Return value

If this function succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Requirements

Requirement Value
Minimum supported client Windows 7 [desktop apps | UWP apps]
Minimum supported server Windows Server 2008 R2 [desktop apps | UWP apps]
Target Platform Windows
Header webservices.h
Library WebServices.lib
DLL WebServices.dll