GetToken

Artículo
10/07/2008

Obtiene un token de seguridad del sistema 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 );

Parámetros

Parámetro	Descripción
cPolicyChain	Número de elementos PolicyChain de la matriz a la que señalada pPolicyChain.
pPolicyChain	Puntero a una matriz de POLICY_ELEMENT, cada uno de los cuales contiene lo siguiente: targetEndpointAddress: extremo del destinatario. issuerEndpointAddress: emisor del token aceptado por el cliente. issuedTokenParameters: directiva asociada al token. privacyNoticeLink: vínculo a un aviso de privacidad. privacyNoticeVersion: versión del aviso de privacidad. useManagedPresentation: determina si se debe usar una presentación administrada. Las direcciones deben ser referencias a extremos de WS-Addressing válidos en XML.
securityToken	Puntero al token de seguridad que se devuelve. Cuando termine de utilizar el token, llame a FreeToken para liberarlo.
phProofTokenCrypto	Identificador de token de la prueba, que se puede utilizar después para realizar la prueba de posesión. Este identificador es un INFORMATIONCARD_CRYPTO_HANDLE de tipo asimétrico o simétrico. Si el tipo de identificador es asimétrico, se puede pasar a las funciones siguientes: Encrypt Decrypt SignHash VerifyHash Si el tipo de identificador es simétrico, se puede pasar a las funciones siguientes: GenerateDerivedKey GetCryptoTransform GetKeyedHash Cuando haya terminado de usar este identificador, ciérrelo mediante la función CloseCryptoHandle.