IOCTL_EHSTOR_BANDMGMT_ERASE_BAND IOCTL(ehstorbandmgmt.h)
IOCTL_EHSTOR_BANDMGMT_ERASE_BAND 요청은 대역의 인증 키를 암호화적으로 지우고 다시 설정합니다. 밴드의 나머지 구성은 수정되지 않은 상태로 유지됩니다.
주 코드
입력 버퍼
Irp-AssociatedIrp.SystemBuffer>의 입력 버퍼에는 ERASE_BAND_PARAMETERS 및 AUTH_KEY 구조체가 포함되어야 합니다.
ERASE_BAND_PARAMETERSNewAuthKeyOffset 멤버가 EHSTOR_BANDMGR_NO_KEY 설정되면 시스템 버퍼의 입력 데이터에 AUTH_KEY 구조가 포함되지 않아도 됩니다.
입력 버퍼 길이
Parameters.DeviceIoControl.InputBufferLength 는 적어도 이어야 하는 sizeof(ERASE_BAND_PARAMETERS) + sizeof(AUTH_KEY)버퍼의 크기(바이트)를 나타냅니다.
출력 버퍼
없음
출력 버퍼 길이
없음
입력/출력 버퍼
없음
입력/출력 버퍼 길이
없음
상태 블록
상태 필드에 다음 값 중 하나를 반환할 수 있습니다.
| 상태 값 | Description |
|---|---|
| STATUS_SUCCESS | 밴드가 성공적으로 지워졌다. |
| STATUS_INVALID_DEVICE_REQUEST | 스토리지 디바이스는 대역 관리를 지원하지 않습니다. |
| STATUS_INVALID_BUFFER_SIZE | 입력 버퍼 크기가 잘못되었습니다. |
| STATUS_INVALID_PARAMETER | 입력 버퍼의 정보가 잘못되었습니다. |
| STATUS_ACCESS_DENIED | 지우기 인증 키는 기본 키가 아니며 밴드를 지울 수 없습니다. |
| STATUS_NOT_FOUND | 제공된 선택 기준에 대한 밴드를 찾을 수 없습니다. |
| STATUS_IO_DEVICE_ERROR | 통신이 실패했습니다. 스토리지 디바이스가 보안 프로토콜과 호환되지 않을 수 있습니다. |
설명
현재 지우기 인증 키는 IOCTL_EHSTOR_BANDMGMT_ERASE_BAND 요청에 제공되지 않습니다. 스토리지 디바이스에 대한 지우기 인증 키가 이전에 구성되었습니다.
스토리지 디바이스의 지우기 인증 키를 변경하는 방법은 Windows에 제공되지 않습니다. 올바른 매개 변수가 시스템 버퍼에 입력으로 제공되면 이 요청이 성공해야 합니다. 다른 운영 체제가 있는 이중 부팅 환경과 같이 Windows 외부에서 지우기 인증 키가 변경된 경우 이 요청이 실패할 수 있습니다.
IOCTL_EHSTOR_BANDMGMT_ERASE_BAND 사용하여 밴드를 지울 때 남아 있는 유일한 이전 속성은 밴드 시작 및 밴드 크기입니다. 이전 미디어 암호화 키가 제거되고 새 키가 생성됩니다. 잠금은 읽기 및 쓰기 모두에 대해 PERSISTANT_UNLOCK 설정됩니다. 이전에 설정된 보안 메타데이터가 지워집니다. 기본 키를 사용하지 않는 한 ERASE_BAND_PARAMETERS 지정된 새 인증 키가 설정됩니다.
다른 애플리케이션이 대역을 제어하고 기본 키를 사용하여 지우지 않도록 하려면 새 인증 키를 IOCTL_EHSTOR_BANDMGMT_ERASE_BAND 요청에 포함해야 합니다.
이 요청에 의해 밴드 테이블에 대한 변경 내용은 IOCTL 요청이 완료되기 전에 디바이스에 원자성으로 커밋됩니다. 따라서 시스템 또는 전원 오류가 발생할 경우 밴드가 모든 속성 집합으로 수정되거나 속성이 전혀 설정되지 않도록 보장됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 8 |
| 머리글 | ehstorbandmgmt.h(EhStorBandMgmt.h 포함) |