다음을 통해 공유

GetToken

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 함수를 사용하여 핸들을 닫습니다.

속성 값/반환 값

HRESULT

요구 사항

Windows Vista

헤더: infocard.h에 선언됨

라이브러리: infocardapi.lib 사용

참고 항목

참조

FreeToken

개념

반환되는 HRESULTS

Footer image

이 항목에 대한 의견을 Microsoft에 보내 주십시오.

Copyright © 2007 by Microsoft Corporation. All rights reserved.

  • Last updated on