GetToken

2007-12-31

从 CardSpace 系统获取安全令牌。

HRESULT
__stdcall GetToken(
        __in DWORD  cPolicyChain,
        __in_ecount( cPolicyChain ) PPOLICY_ELEMENT pPolicyChain,
        __deref_out PGENERIC_XML_TOKEN* securityToken,
        __deref_out PINFORMATIONCARD_CRYPTO_HANDLE* phProofTokenCrypto );

参数

参数	说明
cPolicyChain	pPolicyChain 所指向的数组中的 PolicyChain 元素数目。
pPolicyChain	指向 POLICY_ELEMENT 数组的指针，该数组中的每个元素均包含以下内容： targetEndpointAddress：接收者的终结点。 issuerEndpointAddress：客户端接受的令牌颁发者。 issuedTokenParameters：与令牌关联的策略。 privacyNoticeLink：指向隐私声明的链接。 privacyNoticeVersion：隐私声明的版本。 useManagedPresentation：确定是否要使用托管表示形式。地址应该是 XML 格式的有效 WS-Addressing 终结点引用。
securityToken	指向返回的安全令牌的指针。在使用完令牌后，调用 FreeToken 以释放令牌。
phProofTokenCrypto	以后可用作所有权证明的证明令牌的句柄。此句柄是“非对称”或“对称”类型的 INFORMATIONCARD_CRYPTO_HANDLE。如果句柄类型为“非对称”，则可以将其传递给以下函数： Encrypt Decrypt SignHash VerifyHash 如果句柄类型为“对称”，则可以将其传递给以下函数： GenerateDerivedKey GetCryptoTransform GetKeyedHash 使用完此句柄后，使用 CloseCryptoHandle 函数关闭此句柄。