ISCard::get_Atr 메서드

[ get_Atr 메서드는 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. 스마트 카드 모듈은 비슷한 기능을 제공합니다.]

get_Atr 메서드는 스마트 카드ATR 문자열을 검색합니다.

구문

HRESULT get_Atr(
  [out] LPBYTEBUFFER *ppAtr
);

매개 변수

ppAtr [out]

반환 시 ATR 문자열을 포함할 IStream 형식의 바이트 버퍼에 대한 포인터입니다.

반환 값

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

반환 코드	Description
S_OK	작업이 완료되었습니다.
E_INVALIDARG	ppAtr 매개 변수가 잘못되었습니다.
E_POINTER	잘못된 포인터가 ppAtr에 전달되었습니다.
E_OUTOFMEMORY	요청을 충족하는 메모리를 사용할 수 없습니다.

 

설명

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

예제

다음 예제에서는 스마트 카드 ATR 문자열을 검색하는 방법을 보여줍니다.

// Retrieve the ATR.
// pISCard is a pointer to a previously instantiated ISCard.
// pAtr is a pointer to a previously instantiated IByteBuffer.
hr = pISCard->get_Atr(&pAtr);
if (FAILED(hr))
{
    printf("Failed get_Atr\n");
    // Take other error handling action.
}
// Success, you can now use IByteBuffer::Read to access ATR bytes.
BYTE  byAtr[32];
   long  lBytesRead, i;
   // Read the ATR string into a byte array.
   hr = pAtr->Read(byAtr, 32, &lBytesRead);
   // Use the ATR value. (This example merely displays the bytes.)
   for ( i = 0; i < lBytesRead; i++)
       printf("%c", *(byAtr + i));
   printf("\n");

요구 사항

요구 사항	값
지원되는 최소 클라이언트	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_CardHandle

get_Context

get_Protocol

get_Status

ISCard

IByteBuffer::Read