ISCard::get_Context 메서드

[ get_Context 메서드는 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. Windows Server 2003 SP1(서비스 팩 1) 이상, Windows Vista, Windows Server 2008 및 이후 버전의 운영 체제에서는 사용할 수 없습니다. 스마트 카드 모듈은 유사한 기능을 제공합니다.]

get_Context 메서드는 현재 리소스 관리자 컨텍스트 핸들을 검색합니다. 컨텍스트가 설정되지 않은 경우 이 메서드는 (*pContext) == NULL 을 반환합니다.

구문

HRESULT get_Context(
  [out] HSCARDCONTEXT *pContext
);

매개 변수

pContext [out]

반환할 컨텍스트 핸들에 대한 포인터입니다.

반환 값

메서드는 다음 가능한 값 중 하나를 반환합니다.

반환 코드 설명
S_OK
작업이 완료되었습니다.
E_INVALIDARG
pContext 매개 변수가 잘못되었습니다.
E_POINTER
잘못된 포인터가 pContext에 전달되었습니다.

 

설명

리소스 관리자 컨텍스트는 스마트 카드 함수 SCardEstablishContext를 호출하여 설정됩니다.

위에 나열된 COM 오류 코드 외에도 스마트 카드 함수를 호출하여 요청을 완료한 경우 이 인터페이스는 스마트 카드 오류 코드를 반환할 수 있습니다. 자세한 내용은 스마트 카드 반환 값을 참조하세요.

예제

다음 예제에서는 현재 리소스 관리자 컨텍스트 핸들을 검색하는 방법을 보여줍니다.

HSCARDCONTEXT  hCtx;
HRESULT        hr;

// Retrieve the smart card context.
hr = pISCard->get_Context(&hCtx);
if (FAILED(hr))
{
   printf("Failed get_Context\n");
   // Take other error handling action as needed.
}
// Use smart card context as needed.

요구 사항

요구 사항
지원되는 최소 클라이언트
WINDOWS XP [데스크톱 앱만 해당]
지원되는 최소 서버
Windows Server 2003 [데스크톱 앱만 해당]
클라이언트 지원 종료
Windows XP
서버 지원 종료
Windows Server 2003
헤더
Scardmgr.h
형식 라이브러리
Scardmgr.tlb
DLL
Scardssp.dll
IID
IID_ISCard 1461AAC3-6810-11D0-918F-00AA00C18068로 정의됩니다.

추가 정보

get_Atr

get_CardHandle

get_Protocol

get_Status

ISCard

SCardEstablishContext