SET_BAND_SECURITY_PARAMETERS 구조체(ehstorbandmgmt.h)

IOCTL_EHSTOR_BANDMGMT_SET_BAND_SECURITY 요청에 대한 스토리지 디바이스의 대역에 대한 보안 속성을 설정하는 매개 변수는 SET_BAND_SECURITY_PARAMETERS 구조에 지정됩니다.

구문

typedef struct _SET_BAND_SECURITY_PARAMETERS {
  ULONG         StructSize;
  ULONG         Flags;
  ULONG         Reserved;
  ULONG         BandId;
  LARGE_INTEGER BandStart;
  ULONG         CurrentAuthKeyOffset;
  ULONG         NewAuthKeyOffset;
  ULONG         BandSecurityInfoOffset;
} SET_BAND_SECURITY_PARAMETERS, *PSET_BAND_SECURITY_PARAMETERS;

멤버

StructSize

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

Flags

보안 매개 변수 플래그입니다. 이 값은 다음의 비트 OR 조합입니다.

Reserved

BandId

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

BandStart

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

CurrentAuthKeyOffset

대역의 현재 인증 키를 포함하는 AUTH_KEY 구조체의 오프셋(바이트)입니다. 이 인증 키는 필수이며 이 구조 다음에 있어야 합니다. 오프셋은 SET_BAND_SECURITY_PARAMETERS 시작부터입니다. AUTH_KEY 다음과 같이 ehstorbandmgmt.h 로 선언됩니다.

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

KeySize

Key에 있는 키 데이터의 키 크기(바이트)입니다. KeySize를 0으로 설정하면 기본 키가 사용됩니다.

키

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

대역에 대한 기본 인증 키를 지정하려면 AuthKeyOffset = EHSTOR_BANDMGR_NO_KEY 설정합니다.

NewAuthKeyOffset

대역에 대한 새 인증 키를 포함하는 AUTH_KEY 구조체의 오프셋(바이트)입니다. 오프셋은 SET_BAND_SECURITY_PARAMETERS 시작부터입니다. AUTH_KEY 다음과 같이 ehstorbandmgmt.h 로 선언됩니다.

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

KeySize

Key에 있는 키 데이터의 키 크기(바이트)입니다. KeySize를 0으로 설정하면 기본 키가 사용됩니다.

키

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

대역에 기본 인증 키를 할당하려면 AuthKeyOffset = EHSTOR_BANDMGR_NO_KEY 설정합니다. NewAuthKeyOffset == CurrentAuthKeyOffset인 경우 대역의 인증 키는 변경되지 않은 상태로 유지됩니다.

BandSecurityInfoOffset

BAND_SECURITY_INFO 구조체의 오프셋(바이트)입니다. 오프셋은 SET_BAND_SECURITY_PARAMETERS 시작부터입니다.

설명

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

BandID와 BandStart가 모두 –1로 설정된 경우 IOCTL_EHSTOR_BANDMGMT_SET_BAND_SECURITY 요청은 전역 밴드의 속성을 변경합니다.

NewAuthKeyOffset 및 BandSecurityInfoOffset 은 작업의 요구 사항에 따라 선택 사항입니다. 인증 키만 변경하면 NewAuthKeyOffset 이 새 키에 대한 AUTH_KEY 구조의 위치로 설정되고 BandSecurityInfoOffset 이 0으로 설정됩니다. 마찬가지로 보안 속성만 변경되면 BandSecurityInfoOffset 은 BAND_SECURITY_INFO 위치로 설정되고 NewAuthKeyOffset 은 0으로 설정됩니다.

BandSecurityInfoOffset에서 BAND_SECURITY_INFO 구조의 CryptoAlgoIdType 및 CryptoAlgoOidString 멤버는 밴드 만들기 요청에 사용되지 않으며 0으로 설정해야 합니다.

요구 사항

추가 정보

BAND_LOCATION_INFO

BAND_MANAGEMENT_CAPABILITIES

IOCTL_EHSTOR_BANDMGMT_SET_BAND_LOCATION