다음을 통해 공유

ISCardISO7816::P utData 메서드

  • 아티클

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

PutData 메서드는 선택한 파일에 따라 단일 기본 데이터 개체 또는 생성된 데이터 개체에 포함된 데이터 개체 집합을 저장하는 APDU(애플리케이션 프로토콜 데이터 단위) 명령을 생성합니다.

개체가 저장되는 방식(한 번 쓰기 및/또는 업데이트 및/또는 추가)은 데이터 개체의 정의 또는 특성에 따라 달라집니다.

구문

HRESULT PutData(
  [in]      BYTE         byP1,
  [in]      BYTE         byP2,
  [in]      LPBYTEBUFFER pData,
  [in, out] LPSCARDCMD   *ppCmd
);

매개 변수

byP1 [in]

P1-P2 코딩.

값 의미
0000 - 003F
 RFU
0040 - 00FF
 P2의 BER-TLV 태그(1바이트)
0100 - 01FF
 애플리케이션 데이터(독점 코딩)
0200 - 02FF
 P2의 SIMPLE-TLV 태그
0300 - 03FF
 RFU
0400 - 04FF
 P1-P2의 BER-TLV 태그(2바이트)

 

byP2 [in]

P1-P2 코딩.

값 의미
0000 - 003F
 RFU
0040 - 00FF
 P2의 BER-TLV 태그(1바이트)
0100 - 01FF
 애플리케이션 데이터(독점 코딩)
0200 - 02FF
 P2의 SIMPLE-TLV 태그
0300 - 03FF
 RFU
0400 - 04FF
 P1-P2의 BER-TLV 태그(2바이트)

 

pData [in]

쓸 매개 변수와 데이터가 포함된 바이트 버퍼에 대한 포인터입니다.

ppCmd [in, out]

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

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

반환 값

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

반환 코드 Description
S_OK
 작업이 완료되었습니다.
E_INVALIDARG
 잘못된 매개 변수입니다.
E_POINTER
 잘못된 포인터가 전달되었습니다.
E_OUTOFMEMORY
 메모리가 부족합니다.

 

설명

이 명령은 보안 상태 함수의 컨텍스트 내에서 애플리케이션이 정의한 보안 조건을 충족하는 경우에만 수행할 수 있습니다.

애플리케이션 데이터 저장

P1-P2 값이 0100에서 01FF 범위인 경우 P1-P2 값은 카드 내부 테스트 및 지정된 애플리케이션 컨텍스트 내에서 의미 있는 독점 서비스에 예약된 식별자여야 합니다.

데이터 개체 저장

P1-P2 값이 0040~00FF 범위에 있는 경우 P2 값은 단일 바이트의 BER-TLV 태그여야 합니다. 00FF 값은 데이터 필드에 BER-TLV 데이터 개체가 있음을 나타내기 위해 예약되어 있습니다.

P1-P2 값이 0200~02FF 범위에 있는 경우 P2 값은 SIMPLE-TLV 태그여야 합니다. 값 0200은 RFU입니다. 값 02FF는 데이터 필드에 SIMPLE-TLV 데이터 개체가 있음을 나타내기 위해 예약되어 있습니다.

P1-P2 값이 4000에서 FFFF까지의 범위에 있는 경우 P1-P2 값은 2바이트의 BER-TLV 태그여야 합니다. FFFF에 대한 값 4000은 RFU입니다.

기본 데이터 개체가 제공되면 명령 메시지의 데이터 필드에 해당 기본 데이터 개체의 값이 포함되어야 합니다.

생성된 데이터 개체가 제공되면 명령 메시지의 데이터 필드에는 생성된 데이터 개체의 값(즉, 태그, 길이 및 값을 포함한 데이터 개체)이 포함되어야 합니다.

이 인터페이스에서 제공하는 모든 메서드 목록은 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로 정의됩니다.

추가 정보

GetData

ISCardISO7816