GetToken

Ruft ein Sicherheitstoken aus dem CardSpace-System ab.

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

Parameter

Parameter	Beschreibung
cPolicyChain	Die Anzahl der PolicyChain-Elemente im Array, auf das pPolicyChain zeigt.
pPolicyChain	Zeiger auf ein POLICY_ELEMENT-Array. Alle Elemente enthalten Folgendes: targetEndpointAddress: Den Endpunkt des Empfängers. issuerEndpointAddress: Den Tokenaussteller, der vom Client akzeptiert wird. issuedTokenParameters: Die dem Token zugeordnete Richtlinie. privacyNoticeLink: Link zu einem Datenschutzhinweis. privacyNoticeVersion: Die Version des Datenschutzhinweises. useManagedPresentation: Legt fest, ob eine verwaltete Darstellung verwendet werden soll. Bei den Adressen muss es sich um gültige WS-Addressing-Endpunktverweise in XML handeln.
securityToken	Zeiger auf das Sicherheitstoken, das zurückgegeben wird. Wenn Sie das Token nicht weiter verwenden, rufen Sie FreeToken auf, um das Token freizugeben.
phProofTokenCrypto	Handle für das Prüftoken, das später als Beweis des Besitzes verwendet werden kann. Dieses Handle ist ein INFORMATIONCARD_CRYPTO_HANDLE des Typs Asymmetrisch oder Symmetrisch. Wenn der Handletyp Asymmetrisch ist, kann er an die folgenden Funktionen übergeben werden: Encrypt Decrypt SignHash VerifyHash Wenn der Handletyp Symmetrisch ist, kann er an die folgenden Funktionen übergeben werden: GenerateDerivedKey GetCryptoTransform GetKeyedHash Wenn Sie das Handle nicht weiter verwenden, schließen Sie es mithilfe der CloseCryptoHandle-Funktion.