다음을 통해 공유

CREATE_BAND_PARAMETERS 구조체(ehstorbandmgmt.h)

  • 아티클

IOCTL_EHSTOR_BANDMGMT_CREATE_BAND 요청에 대한 스토리지 디바이스에서 밴드를 만드는 매개 변수는 CREATE_BAND_PARAMETERS 구조에 지정됩니다.

구문

typedef struct _CREATE_BAND_PARAMETERS {
  ULONG StructSize;
  ULONG Flags;
  ULONG BandLocationInfoOffset;
  ULONG BandSecurityInfoOffset;
  ULONG AuthKeyOffset;
} CREATE_BAND_PARAMETERS, *PCREATE_BAND_PARAMETERS;

멤버

StructSize

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

Flags

밴드 생성 플래그입니다. 이 값은 다음의 비트 OR 조합입니다.

값 의미
CREATEBAND_AUTHKEY_CACHING_ENABLED
 이 대역에 대한 인증 키는 캐시되므로 이후 작업을 자동화할 수 있습니다. 이 플래그가 설정되고 밴드가 읽기 및 쓰기 모두에 대해 잠겨 있지 않은 경우 인증 키가 캐시됩니다.

BandLocationInfoOffset

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

BandSecurityInfoOffset

BAND_SECURITY_INFO 구조체의 오프셋(바이트)입니다. 오프셋은 CREATE_BAND_PARAMETERS 시작부터입니다. 이 값이 0이면 대역 보안 정보가 없으므로 대역의 키 관리자 메타데이터가 모든 0으로 설정됩니다. 또한 이 멤버가 0이면 읽기 및 쓰기 잠금 상태는 기본적으로 PERSISTANT_UNLOCK.

AuthKeyOffset

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

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

KeySize

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

키

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

밴드에 기본 권한 부여 키를 할당하려면 AuthKeyOffset = EHSTOR_BANDMGR_NO_KEY 설정합니다.

설명

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

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 8
머리글 ehstorbandmgmt.h(EhStorBandMgmt.h 포함)

추가 정보

BAND_LOCATION_INFO

BAND_SECURITY_INFO

IOCTL_EHSTOR_BANDMGMT_CREATE_BAND