WS_REQUEST_SECURITY_TOKEN_PROPERTY_ID枚举 (webservices.h)

标识用于从颁发者请求安全令牌的属性。 它与 WsRequestSecurityToken 一起使用，作为 WS_REQUEST_SECURITY_TOKEN_PROPERTY* 参数的一部分。

语法

typedef enum {
  WS_REQUEST_SECURITY_TOKEN_PROPERTY_APPLIES_TO = 1,
  WS_REQUEST_SECURITY_TOKEN_PROPERTY_TRUST_VERSION = 2,
  WS_REQUEST_SECURITY_TOKEN_PROPERTY_SECURE_CONVERSATION_VERSION = 3,
  WS_REQUEST_SECURITY_TOKEN_PROPERTY_ISSUED_TOKEN_TYPE = 4,
  WS_REQUEST_SECURITY_TOKEN_PROPERTY_REQUEST_ACTION = 5,
  WS_REQUEST_SECURITY_TOKEN_PROPERTY_EXISTING_TOKEN = 6,
  WS_REQUEST_SECURITY_TOKEN_PROPERTY_ISSUED_TOKEN_KEY_TYPE = 7,
  WS_REQUEST_SECURITY_TOKEN_PROPERTY_ISSUED_TOKEN_KEY_SIZE = 8,
  WS_REQUEST_SECURITY_TOKEN_PROPERTY_ISSUED_TOKEN_KEY_ENTROPY = 9,
  WS_REQUEST_SECURITY_TOKEN_PROPERTY_LOCAL_REQUEST_PARAMETERS = 10,
  WS_REQUEST_SECURITY_TOKEN_PROPERTY_SERVICE_REQUEST_PARAMETERS = 11,
  WS_REQUEST_SECURITY_TOKEN_PROPERTY_MESSAGE_PROPERTIES = 12,
  WS_REQUEST_SECURITY_TOKEN_PROPERTY_BEARER_KEY_TYPE_VERSION = 13
} WS_REQUEST_SECURITY_TOKEN_PROPERTY_ID;

常量

WS_REQUEST_SECURITY_TOKEN_PROPERTY_APPLIES_TO 值：1 指向 WS_ENDPOINT_ADDRESS 结构的指针，其中包含所请求的服务 (“信赖方”) 的地址 将显示 token。 .
WS_REQUEST_SECURITY_TOKEN_PROPERTY_TRUST_VERSION 值： 2 指定要使用的 WS-Trust 版本的WS_TRUST_VERSION值。 如果未指定此属性，则默认为 WS_TRUST_VERSION_FEBRUARY_2005。
WS_REQUEST_SECURITY_TOKEN_PROPERTY_SECURE_CONVERSATION_VERSION 值： 3 WS_SECURE_CONVERSATION_VERSION值 指定WS_REQUEST_SECURITY_TOKEN_ACTION_NEW_CONTEXT时要使用的 WS-SecureConversation 版本 指定 或WS_REQUEST_SECURITY_TOKEN_ACTION_RENEW_CONTEXT 。 如果未指定此属性，则默认为 WS_SECURE_CONVERSATION_VERSION_FEBRUARY_2005。
WS_REQUEST_SECURITY_TOKEN_PROPERTY_ISSUED_TOKEN_TYPE 值： 4 指向 WS_XML_STRING 结构的指针，该结构指定要颁发的安全令牌的类型。 如果未指定此属性， 请求安全令牌消息中未生成相应的元素，并且 假设颁发者知道所需的令牌类型。
WS_REQUEST_SECURITY_TOKEN_PROPERTY_REQUEST_ACTION 值： 5 一个WS_REQUEST_SECURITY_TOKEN_ACTION值，该值指定要与请求一起使用的操作。 默认值为 WS_REQUEST_SECURITY_TOKEN_ACTION_ISSUE。
WS_REQUEST_SECURITY_TOKEN_PROPERTY_EXISTING_TOKEN 值： 6 指向 WS_SECURITY_TOKEN 结构的指针， 如果指定，则通过基于请求新令牌来续订提供的令牌，而不是请求新令牌 现有。 如果此操作成功，旧令牌将变为无效。 仅 支持 WS_REQUEST_SECURITY_TOKEN_ACTION_RENEW_CONTEXT。
WS_REQUEST_SECURITY_TOKEN_PROPERTY_ISSUED_TOKEN_KEY_TYPE 值： 7 一个WS_SECURITY_KEY_TYPE值，该值指定要为 请求的加密密钥的类型 已颁发安全令牌。 这必须设置为 WS_SECURITY_KEY_TYPE_NONE 或 WS_SECURITY_KEY_TYPE_SYMMETRIC。 值WS_SECURITY_KEY_TYPE_NONE指定不带持有者令牌 所有权证明密钥。 此类令牌在用于保护消息时不会生成签名。 如果未指定此属性，则不会在令牌请求中发出相应的键类型元素。 未在令牌请求中发出密钥类型会导致 对称密钥的隐式默认值 已颁发令牌，如 WS-Trust 规范中定义。
WS_REQUEST_SECURITY_TOKEN_PROPERTY_ISSUED_TOKEN_KEY_SIZE 值： 8 一个 ULONG，指定要请求的加密密钥的大小 () 位 在颁发的安全令牌中。 此属性只能指定为 使用对称密钥颁发的令牌。 如果未指定此属性， 令牌请求中不会发出相应的密钥大小元素。
WS_REQUEST_SECURITY_TOKEN_PROPERTY_ISSUED_TOKEN_KEY_ENTROPY 值： 9 一个WS_SECURITY_KEY_ENTROPY_MODE值，该值指定如何为 的加密密钥贡献熵 颁发的令牌。 只能为颁发的令牌指定此属性 使用对称密钥。 如果未指定此属性，则使用 模式WS_SECURITY_KEY_ENTROPY_MODE_SERVER_ONLY 。
WS_REQUEST_SECURITY_TOKEN_PROPERTY_LOCAL_REQUEST_PARAMETERS 值： 10 指向 包含的WS_XML_BUFFER 的指针 请求中要逐字包含的其他主参数 安全令牌消息。 每个此类参数都必须是顶级参数 提供的 XML 缓冲区中的 元素。 如果未指定此属性，则为 不会发出参数。 缓冲区序列化为 RequestSecurityToken 元素 请求安全令牌时。 与 WS_REQUEST_SECURITY_TOKEN_PROPERTY_SERVICE_REQUEST_PARAMETERS 不同，本地请求 参数由客户端定义为向令牌请求添加参数的一种方法。
WS_REQUEST_SECURITY_TOKEN_PROPERTY_SERVICE_REQUEST_PARAMETERS 值： 11 指向 包含的WS_XML_BUFFER 的指针 要包含在请求安全令牌中的服务参数 消息，作为 XML 缓冲区提供。 每个此类参数都必须是 提供的 XML 缓冲区中的顶级元素。 如果未指定此属性，则为 不会发出参数。 如果指定 了WS_TRUST_VERSION_FEBRUARY_2005 ，则会序列化此缓冲区 在 后面的 RequestSecurityToken 元素中 WS_REQUEST_SECURITY_TOKEN_PROPERTY_LOCAL_REQUEST_PARAMETERS。 如果指定 了WS_TRUST_VERSION_1_3 ，则会将此缓冲区序列化为 RequestSecurityToken/SecondaryParameters 元素。 服务请求参数是有关如何颁发令牌的说明。 它们从服务中获取， 通常通过元数据导入。 在这种情况下，可能会获取此参数 从输出。 WS_ISSUED_TOKEN_MESSAGE_SECURITY_BINDING_CONSTRAINT的 RequestSecurityTokenTemplate 字段。
WS_REQUEST_SECURITY_TOKEN_PROPERTY_MESSAGE_PROPERTIES 值： 12 要指定的 WS_MESSAGE_PROPERTIES 集 使用 WsCreateMessage 创建两条消息时， 用于获取交换的安全令牌。 如果此属性 未指定，使用 创建请求和回复消息 默认消息属性。
WS_REQUEST_SECURITY_TOKEN_PROPERTY_BEARER_KEY_TYPE_VERSION 值： 13

要求

要求	值
最低受支持的客户端	Windows 7 [桌面应用 |UWP 应用]
最低受支持的服务器	Windows Server 2008 R2 [桌面应用 |UWP 应用]
标头	webservices.h