Share via

ISCardCmd::get_AlternateClassId 메서드

  • 아티클

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

get_AlternateClassId 메서드는 대체 클래스 ID의 값을 검색합니다. put_AlternateClassId 대한 이전 호출에서 대체 ID를 설정하지 않으면 이 메서드가 실패합니다.

구문

HRESULT get_AlternateClassId(
  [out] BYTE *pbyClass
);

매개 변수

pbyClass [out]

반환 시 대체 클래스 ID 값이 포함된 바이트에 대한 포인터입니다.

반환 값

메서드는 다음과 같은 가능한 값을 반환합니다.

반환 코드 설명
S_OK
 작업이 성공적으로 완료되었습니다.
E_INVALIDARG
 pbyClass 매개 변수가 잘못되었습니다.
E_ACCESSDENIED
 대체 클래스 ID는 이전에 put_AlternateClassId 호출에 의해 설정되지 않았습니다.

 

설명

이 메서드는 T=0 프로토콜을 사용하는 통신에 적용됩니다. 자세한 내용은 put_AlternateClassId 참조하세요.

예제

다음 예제에서는 대체 클래스 ID를 검색하는 방법을 보여 줍니다. 이 예제에서는 pISCardCmd가 ISCardCmd 인터페이스의 instance 대한 유효한 포인터라고 가정합니다.

BYTE     byAltClassID;
HRESULT  hr;

// Retrieve the alternate class ID.
hr = pISCardCmd->get_AlternateClassId(&byAltClassID);
if (FAILED(hr))
{
  printf("Failed get_AltClassId\n");
  // Take other error handling action as needed.
}

요구 사항

요구 사항 값
지원되는 최소 클라이언트
 Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버
 Windows Server 2003 [데스크톱 앱만 해당]
클라이언트 지원 종료
 Windows XP
서버 지원 종료
 Windows Server 2003
헤더
Scarddat.h
유형 라이브러리
Scarddat.tlb
DLL
Scardssp.dll
IID
 IID_ISCardCmd D5778AE3-43DE-11D0-9171-00AA00C18068로 정의됩니다.

추가 정보

ISCardCmd

put_AlternateClassId