ISCardISO7816::ReadRecord 메서드
[ ReadRecord 메서드는 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. Windows Server 2003 SP1(서비스 팩 1) 이상, Windows Vista, Windows Server 2008 및 이후 버전의 운영 체제에서는 사용할 수 없습니다. 스마트 카드 모듈은 비슷한 기능을 제공합니다.]
ReadRecord 메서드는 지정된 레코드의 내용 또는 기본 파일의 한 레코드의 시작 부분을 읽는 APDU(애플리케이션 프로토콜 데이터 단위) 명령을 생성합니다.
구문
HRESULT ReadRecord(
[in] BYTE byRecordId,
[in] BYTE byRefCtrl,
[in] LONG lBytesToRead,
[in, out] LPSCARDCMD *ppCmd
);
매개 변수
-
byRecordId [in]
-
읽을 첫 번째 레코드의 레코드 번호 또는 ID입니다(00은 현재 레코드를 나타낸다).
-
byRefCtrl [in]
-
참조 컨트롤의 코딩입니다.
값 의미 - 현재 EF
비트 위치: 00000---
현재 선택된 EF입니다.- 짧은 EF ID
비트 위치: xxxxx---
짧은 EF 식별자입니다.- RFU
비트 위치: 11111--- - 레코드 #
비트 위치: -----1xx
P1의 레코드 번호 사용.- 레코드 읽기
비트 위치: -----100
레코드 P1을 읽습니다.- 최대 마지막까지
비트 위치: -----101
P1에서 마지막까지 모든 레코드를 읽습니다.- 최대 P1
비트 위치: -----110
마지막부터 P1까지의 모든 레코드를 읽습니다.- RFU
비트 위치: -----11 - 레코드 ID
비트 위치: -----0xx
P1의 레코드 번호 사용.- 첫 번째 발생
비트 위치: -----000
첫 번째 항목을 읽습니다.- 마지막 발생
비트 위치: -----001
마지막 항목을 읽습니다.- 다음 발생
비트 위치: -----010
다음 항목을 읽습니다.- 이전
비트 위치: -----011
이전 항목을 읽습니다.- 비밀
비트 위치: ---xxxxx -
lBytesToRead [in]
-
투명한 EF에서 읽을 바이트 수입니다.
Le 필드에 0만 포함된 경우 P2의 b3b2b1에 따라 짧은 길이는 256, 확장 길이는 65536으로 제한되면 명령은 요청된 단일 레코드 또는 요청된 레코드 시퀀스를 완전히 읽어야 합니다.
-
ppCmd [in, out]
-
입력에서 ISCardCmd 인터페이스 개체 또는 NULL에 대한 포인터입니다.
반환 시 이 작업에 의해 생성된 APDU 명령으로 채워집니다. ppCmd가 NULL로 설정된 경우 스마트 카드ISCardCmd 개체가 내부적으로 만들어지고 ppCmd 포인터를 통해 반환됩니다.
반환 값
메서드는 다음 가능한 값 중 하나를 반환합니다.
| 반환 코드 | Description |
|---|---|
|
작업이 완료되었습니다. |
|
잘못된 매개 변수입니다. |
|
잘못된 포인터가 전달되었습니다. |
|
메모리가 부족합니다. |
설명
캡슐화된 명령은 스마트 카드 보안 상태 읽는 기본 파일의 보안 특성을 충족하는 경우에만 수행할 수 있습니다.
이 명령을 실행할 때 다른 기본 파일이 현재 선택된 경우 현재 선택된 파일을 식별하지 않고 처리할 수 있습니다.
명령에 유효한 짧은 기본 식별자가 포함된 경우 파일을 현재 기본 파일로 설정합니다.
레코드 구조가 없는 기본 파일은 읽을 수 없습니다. 레코드 구조 없이 기본 파일에 적용하면 캡슐화된 명령이 중단됩니다.
이 인터페이스에서 제공하는 모든 메서드 목록은 ISCardISO7816을 참조하세요.
위에 나열된 COM 오류 코드 외에도 스마트 카드 함수를 호출하여 요청을 완료한 경우 이 인터페이스는 스마트 카드 오류 코드를 반환할 수 있습니다. 자세한 내용은 스마트 카드 반환 값을 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 |
Windows Server 2003 [데스크톱 앱만 해당] |
| 클라이언트 지원 종료 |
Windows XP |
| 서버 지원 종료 |
Windows Server 2003 |
| 헤더 |
|
| 유형 라이브러리 |
|
| DLL |
|
| IID |
IID_ISCardISO7816 53B6AA68-3F56-11D0-916B-00AA00C18068로 정의됩니다. |
추가 정보