GetToken

Article
04/22/2008

Obtient un jeton de sécurité du système 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 );

Paramètres

Paramètre	Description
cPolicyChain	Nombre d'éléments PolicyChain dans le tableau pointé par pPolicyChain.
pPolicyChain	Pointeur vers un tableau de POLICY_ELEMENT, dont chacun contient les éléments suivants : targetEndpointAddress : le point de terminaison du destinataire. issuerEndpointAddress : l'émetteur du jeton accepté par le client. issuedTokenParameters : la stratégie associée au jeton. privacyNoticeLink : lien vers une information préalable de confidentialité. privacyNoticeVersion : version de l'information préalable de confidentialité. useManagedPresentation : détermine si une présentation managée doit être utilisée. Les adresses doivent être des références valides à un point de terminaison WS-Addressing en XML.
securityToken	Pointeur vers le jeton de sécurité retourné. Lorsque vous avez terminé d'utiliser le jeton, appelez FreeToken pour libérer le jeton.
phProofTokenCrypto	Handle du jeton de preuve qui peut être utilisé ultérieurement pour la preuve de possession. Ce handle est un INFORMATIONCARD_CRYPTO_HANDLE de type asymétrique ou symétrique. Si le type de handle est asymétrique, il peut être passé aux fonctions suivantes : Encrypt Decrypt SignHash VerifyHash Si le type de handle est symétrique, il peut être passé aux fonctions suivantes : GenerateDerivedKey GetCryptoTransform GetKeyedHash Lorsque vous avez fini d'utiliser ce handle, fermez-le à l'aide de la fonction CloseCryptoHandle.