GetToken

Ottiene un token di protezione dal 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 );

Parametri

Parametro	Descrizione
cPolicyChain	Numero di elementi PolicyChain nella matrice a cui fa riferimento pPolicyChain.
pPolicyChain	Puntatore a una matrice di POLICY_ELEMENT, ognuno dei quali contenente gli elementi seguenti: targetEndpointAddress: endpoint del destinatario. issuerEndpointAddress: emittente del token accettato dal client. issuedTokenParameters: criterio associato al token. privacyNoticeLink: collegamento all'informativa sulla privacy. privacyNoticeVersion: versione dell'informativa sulla privacy. useManagedPresentation: determina se deve essere utilizzata una presentazione gestita. Gli indirizzi devono essere riferimenti a endpoint WS-Addressing validi in XML.
securityToken	Puntatore al token di protezione restituito. Dopo aver utilizzato il token, chiamare FreeToken per liberare il token.
phProofTokenCrypto	Handle per il token di prova, che può essere utilizzato in un momento successivo per la prova di possesso. L'handle è un INFORMATIONCARD_CRYPTO_HANDLE di tipo asimmetrico o simmetrico. Se il tipo di handle è asimmetrico, può essere passato alle funzioni seguenti: Encrypt Decrypt SignHash VerifyHash Se il tipo di handle è simmetrico, può essere passato alle funzioni seguenti: GenerateDerivedKey GetCryptoTransform GetKeyedHash Dopo aver utilizzato l'handle, chiuderlo utilizzando la funzione CloseCryptoHandle.