ISCardISO7816::Verify 메서드

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

Verify 메서드는 카드 저장된 참조 데이터(예: 암호)를 사용하여 인터페이스 디바이스에서 보낸 확인 데이터의 비교(카드)를 시작하는 APDU(애플리케이션 프로토콜 데이터 단위) 명령을 생성합니다.

구문

HRESULT Verify(
  [in]      BYTE         byRefCtrl,
  [in]      LPBYTEBUFFER pData,
  [in, out] LPSCARDCMD   *ppCmd
);

매개 변수

byRefCtrl [in]

참조 데이터의 수량자입니다. 참조 컨트롤 P2의 코딩은 다음과 같습니다.

본문이 비어 있으면 명령을 사용하여 추가 허용 재시도의 'X' 번호(SW1-SW2=63CX)를 검색하거나 확인이 필요하지 않은지 여부를 검사 수 있습니다(SW1-SW2=9000).

값	의미
정보 없음	비트 위치: 000000000 P2=00은 verify 명령이 비밀 데이터를 명확하게 참조하는 카드에서 특정 한정자를 사용하지 않음을 나타내기 위해 예약되어 있습니다.
Global Ref	비트 위치: 0------- Global Ref의 예는 암호입니다.
특정 참조	비트 위치: 1------- 특정 참조의 예로 DF 특정 암호가 있습니다.
RFU	비트 위치: -xx-----
Ref 데이터 #	비트 위치: ---xxxxx 참조 데이터 번호는 암호 번호 또는 짧은 EF 식별자일 수 있습니다.

 

pData [in]

확인 데이터에 대한 포인터입니다. 이 매개 변수는 NULL일 수 있습니다. 기본값은 NULL입니다.

ppCmd [in, out]

입력에서 ISCardCmd 인터페이스 개체 또는 NULL에 대한 포인터입니다.

반환 시 이 작업에 의해 생성된 APDU 명령으로 채워집니다. ppCmd가 NULL로 설정된 경우 스마트 카드ISCardCmd 개체가 내부적으로 만들어지고 ppCmd 포인터를 사용하여 반환됩니다.

반환 값

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

반환 코드	Description
S_OK	작업이 성공적으로 완료되었습니다.
E_INVALIDARG	유효하지 않은 매개 변수가 사용되었습니다.
E_POINTER	잘못된 포인터가 전달되었습니다.
E_OUTOFMEMORY	메모리가 부족합니다.

 

설명

보안 상태 비교의 결과로 수정될 수 있습니다. 실패한 비교는 카드 기록될 수 있습니다(예: 참조 데이터 사용의 추가 시도 횟수를 제한하기 위해).

이 인터페이스에서 제공하는 모든 메서드 목록은 ISCardISO7816을 참조하세요.

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

요구 사항

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

추가 정보

ISCardISO7816