次の方法で共有

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

この構造体のサイズ (バイト単位)。 (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

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

鍵

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

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

備考

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

必要条件

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

関連項目

BAND_LOCATION_INFO

BAND_SECURITY_INFO

IOCTL_EHSTOR_BANDMGMT_CREATE_BAND