Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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) |