Share via

ISCardISO7816::EraseBinary 메서드

  • 아티클

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

EraseBinary 메서드는 기본 파일의 콘텐츠 일부를 지정된 오프셋부터 시작하여 논리적 지우기 상태로 순차적으로 설정하는 APDU(애플리케이션 프로토콜 데이터 단위) 명령을 생성합니다.

구문

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

매개 변수

byP1 [in]

RFU 위치입니다.

P1에서 b8=1이면 P1의 b7 및 b6이 0(RFU 비트)으로 설정되고 P1의 b5~b1은 짧은 EF 식별자이며 P2는 파일의 시작 부분에서 지울 첫 번째 바이트의 오프셋입니다(데이터 단위).

P1에서 b8=0이면 P1 || P2는 파일의 시작 부분에서 지울 첫 번째 바이트(데이터 단위)의 오프셋입니다.

데이터 필드가 있는 경우 지울 수 없는 첫 번째 데이터 단위의 오프셋을 코딩합니다. 이 오프셋은 P1-P2로 코딩된 오프셋보다 높아야 합니다. 데이터 필드가 비어 있으면 명령이 파일의 끝까지 지워집니다.

byP2 [in]

RFU 위치입니다.

P1에서 b8=1이면 P1의 b7 및 b6이 0(RFU 비트)으로 설정되고 P1의 b5~b1은 짧은 EF 식별자이며 P2는 파일의 시작 부분에서 지울 첫 번째 바이트의 오프셋입니다(데이터 단위).

P1에서 b8=0이면 P1 || P2는 파일의 시작 부분에서 지울 첫 번째 바이트(데이터 단위)의 오프셋입니다.

데이터 필드가 있는 경우 지울 수 없는 첫 번째 데이터 단위의 오프셋을 코딩합니다. 이 오프셋은 P1-P2로 코딩된 오프셋보다 높아야 합니다. 데이터 필드가 비어 있으면 명령이 파일의 끝까지 지워집니다.

pData [in]

지우기 범위를 지정하는 데이터에 대한 포인터입니다. 이 매개 변수는 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

ReadBinary

UpdateBinary

WriteBinary