WS_SECURITY_DESCRIPTION structure (webservices.h)

The top-level structure used to specify the security requirements for a channel (on the client side) or a listener (on the server side).

Syntax

typedef struct _WS_SECURITY_DESCRIPTION {
  WS_SECURITY_BINDING  **securityBindings;
  ULONG                securityBindingCount;
  WS_SECURITY_PROPERTY *properties;
  ULONG                propertyCount;
} WS_SECURITY_DESCRIPTION;

Members

securityBindings

The array of pointers to security bindings. The set of security bindings supplies determines the kind of security applied to the channel. Each security binding specifies one security token.

securityBindingCount

The count of elements in the securityBindings array.

properties

The array of properties specifying the optional channel-wide security settings. Each WS_SECURITY_PROPERTY in the array is a key-value pair and must use a key defined in WS_SECURITY_PROPERTY_ID. This field can be NULL, and if it is NULL, the default value will be used for each security channel setting.

propertyCount

The count of elements in the properties array.

Remarks

The figure below illustrates the structure of a security description.

Diagram of the elements in a security description. A Channel-wide Settings Bag,  a Security Binding, and the properties of the Security Binding.

Requirements

Requirement Value
Minimum supported client Windows 7 [desktop apps | UWP apps]
Minimum supported server Windows Server 2008 R2 [desktop apps | UWP apps]
Header webservices.h