IOCTL_EHSTOR_BANDMGMT_ACTIVATE IOCTL (ehstorbandmgmt.h)
Diese IOCTL_EHSTOR_BANDMGMT_ACTIVATE Anforderung wird gesendet, um die Sicherheitsfeatures und die Bandverwaltung auf einem Speichergerät zu aktivieren. Die Anforderung enthält Aktivierungsoptionen und den Authentifizierungsschlüssel.
Hauptcode
Eingabepuffer
Der Eingabepuffer bei Irp->AssociatedIrp.SystemBuffer enthält eine ACTIVATE_REVERT_PARAMETERS Struktur. ACTIVATE_REVERT_PARAMETERS wird in ehstorbandmgmt.h wie folgt deklariert.
typedef struct _ACTIVATE_REVERT_PARAMETERS
{
ULONG StructSize;
ULONG Flags;
ULONG AuthKeyOffset;
} ACTIVATE_REVERT_PARAMETERS;
Das Folgen ACTIVATE_REVERT_PARAMETERS im Systempuffer ist eine AUTH_KEY Struktur. Dies enthält die Schlüsseldatenbytes für den Authentifizierungsschlüssel. AUTH_KEY wird in ehstorbandmgmt.h wie folgt deklariert.
typedef struct _AUTH_KEY
{
ULONG KeySize;
UCHAR Key[ANYSIZE_ARRAY];
} AUTH_KEY;
Eingabepufferlänge
Die Länge einer ACTIVATE_REVERT_PARAMETERS Struktur.
Ausgabepuffer
Nichts.
Länge des Ausgabepuffers
Nichts.
Statusblock
Einer der folgenden Werte kann im Feld Status zurückgegeben werden.
| Statuswert | Beschreibung |
|---|---|
| STATUS_SUCCESS | Sicherheitsfeatures auf dem Speichergerät wurden aktiviert. |
| STATUS_INVALID_DEVICE_REQUEST | Das Speichergerät unterstützt keine Bandverwaltung. |
| STATUS_INVALID_BUFFER_SIZE | Die Größe des Eingabepuffers ist ungültig. |
| STATUS_INVALID_PARAMETER | Die Informationen im Eingabepuffer sind ungültig. |
| STATUS_ACCESS_DENIED | Der Authentifizierungsschlüssel ist ungültig. Die Aktivierung wird verweigert. |
| STATUS_DEVICE_CONFIGURATION_ERROR | Das System kann das Gerät nicht in einem unterstützten Modus konfigurieren. |
| STATUS_IO_DEVICE_ERROR | Kommunikationsfehler. Das Speichergerät ist möglicherweise nicht mit Sicherheitsprotokollen kompatibel. |
| STATUS_INVALID_DEVICE_STATE | Das Speichergerät ist bereits aktiviert. |
| STATUS_NOT_SUPPORTED | Sicherheitsfeatures auf dem Gerät wurden aufgrund einer Gruppenrichtlinieneinstellung nicht aktiviert. |
Bemerkungen
Wenn STATUS_SUCCESS von dieser Anforderung zurückgegeben wird, kann ein Treiber oder eine Anwendung eine IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES Anforderung senden, um die aktivierten Bandverwaltungsfunktionen des Geräts abzurufen.
Vor einer erfolgreichen Rückgabe von IOCTL_EHSTOR_BANDMGMT_ACTIVATEwird das Gerät nicht aktiviert. Bis zum Aktivieren des Geräts wird die einzige IOCTL-Bandverwaltung, die erfolgreich zurückgegeben wird, IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES. Nach der Aktivierung sind die verbleibenden Bandverwaltungs-IOCTLs verfügbar.
Die Aktivierung erweiterter Speichergeräte wird durch die Gruppenrichtlinieneinstellungen des Systems gesteuert. Der Registrierungswert bei HKLM\Software\Policies\Microsoft\Windows\EnhancedStorageDevices\TCGSecurityActivationDisabled bestimmt, ob die Sicherheitsaktivierung aktiviert ist. Ein REG_DWORD Wert von 0 ermöglicht die Sicherheitsaktivierung auf dem Speichergerät. Andernfalls deaktiviert der Wert 1 die Sicherheitsaktivierung, und die IOCTL_EHSTOR_BANDMGMT_ACTIVATE-Anforderung wird mit STATUS_NOT_SUPPORTED zurückgegeben.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Verfügbar ab Windows 8. |
| Header- | ehstorbandmgmt.h (einschließlich EhStorBandMgmt.h) |