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 の場合、読み取りと書き込みのロック状態は既定で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

Key のキー データのキーのサイズ (バイト単位)。 KeySize が 0 に設定されている場合は、既定のキーが使用されます。

キー

キー データを含む可変長バイト配列。

既定の承認キーをバンドに割り当てるには、 AuthKeyOffset = EHSTOR_BANDMGR_NO_KEYを設定します。

注釈

BandSecurityInfoOffset のBAND_SECURITY_INFO構造体の CryptoAlgoIdType メンバーと CryptoAlgoOidString メンバーは、バンド作成要求では使用されず、0 に設定する必要があります。

要件

要件 値
サポートされている最小のクライアント Windows 8 以降で使用可能
Header ehstorbandmgmt.h (EhStorBandMgmt.h を含む)

こちらもご覧ください

BAND_LOCATION_INFO

BAND_SECURITY_INFO

IOCTL_EHSTOR_BANDMGMT_CREATE_BAND