ne-webservices-ws_security_token_reference_mode.md

UID	title	description	helpviewer_keywords	old-location	tech.root	ms.assetid	ms.date	ms.keywords	req.header	req.include-header	req.target-type	req.target-min-winverclnt	req.target-min-winversvr	req.kmdf-ver	req.umdf-ver	req.ddi-compliance	req.unicode-ansi	req.idl	req.max-support	req.namespace	req.assembly	req.type-library	req.lib	req.dll	req.irql	targetos	req.typenames	req.redist	ms.custom	f1_keywords	dev_langs	topic_type	api_type	api_location	api_name
NE:webservices.WS_SECURITY_TOKEN_REFERENCE_MODE	WS_SECURITY_TOKEN_REFERENCE_MODE (webservices.h)	With message and mixed-mode security bindings, the mechanism to use to refer to a security token from signatures, encrypted items and derived tokens.	WS_SECURITY_TOKEN_REFERENCE_MODE WS_SECURITY_TOKEN_REFERENCE_MODE enumeration [Web Services for Windows] WS_SECURITY_TOKEN_REFERENCE_MODE_CERT_THUMBPRINT WS_SECURITY_TOKEN_REFERENCE_MODE_LOCAL_ID WS_SECURITY_TOKEN_REFERENCE_MODE_SAML_ASSERTION_ID WS_SECURITY_TOKEN_REFERENCE_MODE_SECURITY_CONTEXT_ID WS_SECURITY_TOKEN_REFERENCE_MODE_XML_BUFFER webservices/WS_SECURITY_TOKEN_REFERENCE_MODE webservices/WS_SECURITY_TOKEN_REFERENCE_MODE_CERT_THUMBPRINT webservices/WS_SECURITY_TOKEN_REFERENCE_MODE_LOCAL_ID webservices/WS_SECURITY_TOKEN_REFERENCE_MODE_SAML_ASSERTION_ID webservices/WS_SECURITY_TOKEN_REFERENCE_MODE_SECURITY_CONTEXT_ID webservices/WS_SECURITY_TOKEN_REFERENCE_MODE_XML_BUFFER wsw.ws_security_token_reference_mode	wsw\ws_security_token_reference_mode.htm	wsw	09cd0350-d310-4335-9850-e0f6246be472	12/05/2018	WS_SECURITY_TOKEN_REFERENCE_MODE, WS_SECURITY_TOKEN_REFERENCE_MODE enumeration [Web Services for Windows], WS_SECURITY_TOKEN_REFERENCE_MODE_CERT_THUMBPRINT, WS_SECURITY_TOKEN_REFERENCE_MODE_LOCAL_ID, WS_SECURITY_TOKEN_REFERENCE_MODE_SAML_ASSERTION_ID, WS_SECURITY_TOKEN_REFERENCE_MODE_SECURITY_CONTEXT_ID, WS_SECURITY_TOKEN_REFERENCE_MODE_XML_BUFFER, webservices/WS_SECURITY_TOKEN_REFERENCE_MODE, webservices/WS_SECURITY_TOKEN_REFERENCE_MODE_CERT_THUMBPRINT, webservices/WS_SECURITY_TOKEN_REFERENCE_MODE_LOCAL_ID, webservices/WS_SECURITY_TOKEN_REFERENCE_MODE_SAML_ASSERTION_ID, webservices/WS_SECURITY_TOKEN_REFERENCE_MODE_SECURITY_CONTEXT_ID, webservices/WS_SECURITY_TOKEN_REFERENCE_MODE_XML_BUFFER, wsw.ws_security_token_reference_mode	webservices.h		Windows	Windows 7 [desktop apps only]	Windows Server 2008 R2 [desktop apps only]													Windows	WS_SECURITY_TOKEN_REFERENCE_MODE		19H1	WS_SECURITY_TOKEN_REFERENCE_MODE webservices/WS_SECURITY_TOKEN_REFERENCE_MODE	c++	APIRef kbSyntax	HeaderDef	WebServices.h	WS_SECURITY_TOKEN_REFERENCE_MODE

WS_SECURITY_TOKEN_REFERENCE_MODE enumeration

-description

With message and mixed-mode security bindings, the mechanism to use to refer to a security token from signatures, encrypted items and derived tokens. The security runtime can use the right reference on its own most of the time, and this needs to be explicitly set only when a specific reference mechanism is required, typically for interop with another platform that supports only that reference form.

-enum-fields

-field WS_SECURITY_TOKEN_REFERENCE_MODE_LOCAL_ID:1

The id of the serialized security token is used to refer to it. This reference mechanism can be used only when the security token is serialized in the same message as the item (such as a signature) that needs to refer to the security token.

-field WS_SECURITY_TOKEN_REFERENCE_MODE_XML_BUFFER:2

An opaque XML buffer that is used as a token reference (for example, as in a custom token).

-field WS_SECURITY_TOKEN_REFERENCE_MODE_CERT_THUMBPRINT:3

The thumbprint of a certificate is used to refer to it.

-field WS_SECURITY_TOKEN_REFERENCE_MODE_SECURITY_CONTEXT_ID:4

The context-id is used to refer to a security context token.

-field WS_SECURITY_TOKEN_REFERENCE_MODE_SAML_ASSERTION_ID:5

The SAML assertion ID is used to refer to the SAML token.