DELETE_BAND_PARAMETERS 구조체(ehstorbandmgmt.h)

구성된 밴드는 DELETE_BAND_PARAMETERS 구조의 매개 변수에 따라 삭제됩니다. 이 구조는 IOCTL_EHSTOR_BANDMGMT_DELETE_BAND 요청에 대한 입력입니다.

통사론

typedef struct _DELETE_BAND_PARAMETERS {
  ULONG         StructSize;
  ULONG         Flags;
  ULONG         Reserved;
  ULONG         BandId;
  LARGE_INTEGER BandStart;
  ULONG         AuthKeyOffset;
} DELETE_BAND_PARAMETERS, *PDELETE_BAND_PARAMETERS;

회원

StructSize

이 구조체의 크기(바이트)입니다. sizeof(DELETE_BAND_PARAMETERS)로 설정합니다.

Flags

작업 플래그를 삭제합니다. 이 값은 다음의 비트 OR 조합입니다.

값	의미
DELBAND_ERASE_BEFORE_DELETE	삭제하기 전에 대역 속성 데이터의 암호화 지우기를 수행합니다.

Reserved

예약.

BandId

정보를 반환할 단일 대역의 식별자입니다. BandSizeBandId사용하여 단일 밴드를 선택하면 0이어야 합니다. bandId 대신 BandStart 및 BandSize 사용하여 밴드를 선택하려면 BandId = (ULONG) –1을 설정합니다.

BandStart

대역 검색을 시작할 스토리지 디바이스의 시작 바이트 위치입니다. BandStart이후에 밴드를 일치시키려고 시도합니다.

AuthKeyOffset

밴드에 대한 권한 부여 키를 포함하는 AUTH_KEY 구조체의 오프셋(바이트)입니다. 오프셋은 DELETE_BAND_PARAMETERS시작부터입니다. AUTH_KEYehstorbandmgmt.h 다음과 같이 선언됩니다.

typedef struct _AUTH_KEY
{
    ULONG   KeySize;
    UCHAR   Key[ANYSIZE_ARRAY];
} AUTH_KEY;

KeySize

Key키 데이터의 키 크기(바이트)입니다. KeySize 0으로 설정된 경우 기본 키가 사용됩니다.

열쇠

키 데이터를 포함하는 가변 길이 바이트 배열입니다.

대역에 대한 기본 인증 키를 지정하려면 AuthKeyOffset = EHSTOR_BANDMGR_NO_KEY설정합니다. 플래그DELBAND_ERASE_BEFORE_DELETE포함하는 경우 AuthKeyOffsetEHSTOR_BANDMGR_NO_KEY설정해야 합니다.

발언

밴드 선택에 대한 BandID 우선 순위가 지정됩니다. BandID 0보다 크고 BandIDBAND_MANAGEMENT_CAPABILITIESMaxBandCount 멤버보다 작으면 BandID 밴드 일치의 유일한 선택 조건으로 사용됩니다. BandID == –1이면 BandStart 밴드를 선택하는 일치 조건으로 사용됩니다. 선택 조건과 일치하는 밴드가 없으면 IOCTL_EHSTOR_BANDMGMT_DELETE_BANDIoStatus 블록에 STATUS_INVALID_PARAMETER 반환됩니다.

DELBAND_ERASE_BEFORE_DELETEFlags설정된 경우 대역을 삭제하는 데 인증 키가 필요하지 않습니다. 이 플래그를 설정하지 않으면 현재 인증 키가 AuthKeyOffset포함되어야 합니다.

.

요구 사항

요구	값
지원되는 최소 클라이언트	Windows 8부터 사용 가능
헤더	ehstorbandmgmt.h(EhStorBandMgmt.h 포함)

참고 항목

BAND_MANAGEMENT_CAPABILITIES

IOCTL_EHSTOR_BANDMGMT_DELETE_BAND

IOCTL_EHSTOR_BANDMGMT_ERASE_BAND