IOCTL_EHSTOR_BANDMGMT_SET_BAND_METADATA IOCTL(ehstorbandmgmt.h)
밴드와 연결된 메타데이터는 IOCTL_EHSTOR_BANDMGMT_SET_BAND_METADATA 요청으로 설정됩니다. 대역에 대한 메타데이터는 키 관리자 애플리케이션의 데이터 영역 역할을 합니다.
주 코드
입력 버퍼
Irp->AssociatedIrp.SystemBuffer 입력 버퍼에는 밴드에 대해 설정할 새 메타데이터와 함께 SET_BAND_METADATA_PARAMETERS 및 AUTH_KEY 구조가 포함되어야 합니다.
SET_BAND_METADATA_PARAMETERSAuthKeyOffset 멤버가 EHSTOR_BANDMGR_NO_KEY설정되면 시스템 버퍼의 입력 데이터에 AUTH_KEY 구조가 포함되지 않아도 됩니다.
입력 버퍼 길이
Parameters.DeviceIoControl.InputBufferLength 버퍼의 크기를 바이트 단위로 나타내며, 이 크기는 ( SET_BAND_METADATA_PARAMETERS) + MetadataSize + sizeof(AUTH_KEY) 이상이어야 합니다.
출력 버퍼
없음.
출력 버퍼 길이
없음.
상태 블록
다음 값 중 하나가 상태 필드에 반환될 수 있습니다.
| 상태 값 | 묘사 |
|---|---|
| STATUS_SUCCESS | 선택한 밴드에 대해 메타데이터가 설정되었습니다. |
| STATUS_INVALID_DEVICE_REQUEST | 스토리지 디바이스는 대역 관리를 지원하지 않습니다. |
| STATUS_INVALID_BUFFER_SIZE | 입력 버퍼 크기가 잘못되었습니다. |
| STATUS_INVALID_PARAMETER | 입력 버퍼의 정보가 잘못되었습니다. |
| STATUS_NOT_FOUND | 제공된 선택 기준에 대한 밴드를 찾을 수 없습니다. |
| STATUS_IO_DEVICE_ERROR | 통신이 실패했습니다. 스토리지 디바이스가 보안 프로토콜과 호환되지 않을 수 있습니다. |
발언
이 IOCTL을 사용하여 메타데이터를 지울 수도 있습니다. 대역에 대한 메타데이터를 지우려면 입력 버퍼의 메타데이터 부분을 모두 0 또는 다른 지우기 패턴으로 설정합니다. 메타데이터 Blob에서 중요한 정보를 제거하려면 사일로 드라이버의 밴드 테이블에서 밴드를 삭제하기 전에 이 지우기 작업을 수행해야 합니다.
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 8 이상 버전의 Windows에서 사용할 수 있습니다. |
| 헤더 | ehstorbandmgmt.h(EhStorBandMgmt.h 포함) |