WS_USERNAME_MESSAGE_SECURITY_BINDING_TEMPLATE structure (webservices.h)

The security binding template for specifying the use of an application supplied username / password pair as a direct (i.e., one-shot) security token. This security binding may be used only with message security. It provides client authentication, but not traffic signing or encryption. So, it is used in conjunction with another transport security or message security binding that provides message protection.

See also WS_USERNAME_MESSAGE_SECURITY_BINDING

Syntax

typedef struct _WS_USERNAME_MESSAGE_SECURITY_BINDING_TEMPLATE {
  WS_SECURITY_BINDING_PROPERTIES securityBindingProperties;
  WS_USERNAME_CREDENTIAL         *clientCredential;
  WS_VALIDATE_PASSWORD_CALLBACK  passwordValidator;
  void                           *passwordValidatorCallbackState;
} WS_USERNAME_MESSAGE_SECURITY_BINDING_TEMPLATE;

Members

securityBindingProperties

Application provided security binding properties that cannot be represented in policy.

clientCredential

The username credential to be used with this security binding. This needs to be specified when this security binding is used on the client.

passwordValidator

The validator to be used to check received username/password pairs. This needs to be specified when this security binding is used on the service.

passwordValidatorCallbackState

The optional state to be passed in as an argument when the username validator is invoked.

Requirements

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