Security Processing Results

On a secure channel, only those messages that successfully pass security checks are delivered to the application. For these messages, some results from security verification are attached as message properties, and the application may extract and examine these properties to perform additional steps such as authorization checks.

The function WsGetMessageProperty can be used to retrieve any of the security-related properties defined in WS_MESSAGE_PROPERTY_ID. WsGetMessageProperty returns an error for queries that ask for security properties not applicable to the type of security used on the channel. The message continues to own the properties returned by the query function.

The following API elements are used with security processing results.

Enumeration	Description
WS_SECURITY_TOKEN_PROPERTY_ID	Defines the keys for the fields and properties that can be extracted from a security token.

 

Function	Description
WsGetSecurityTokenProperty	Extracts a field or a property from a security token.

 

Handle	Description
WS_SECURITY_TOKEN	An opaque handle representing a security token.