IOCTL_EHSTOR_BANDMGMT_REVERT IOCTL(ehstorbandmgmt.h)

아티클
02/06/2025

이 IOCTL_EHSTOR_BANDMGMT_REVERT 요청은 스토리지 디바이스에서 보안 기능 및 대역 관리를 비활성화하기 위해 전송됩니다. 요청에는 되돌리기 옵션 및 인증 키가 포함됩니다.

주 코드

입력 버퍼

Irp->AssociatedIrp.SystemBuffer 입력 버퍼에는 ACTIVATE_REVERT_PARAMETERS 구조체가 포함되어 있습니다. ACTIVATE_REVERT_PARAMETERS 다음과 같이 ehstorbandmgmt.h 선언됩니다.

typedef struct _ACTIVATE_REVERT_PARAMETERS
{
    ULONG           StructSize;
    ULONG           Flags;
    ULONG           AuthKeyOffset;
} ACTIVATE_REVERT_PARAMETERS;

시스템 버퍼의 다음 ACTIVATE_REVERT_PARAMETERSAUTH_KEY 구조입니다. 인증 키에 대한 키 데이터 바이트를 보유합니다. AUTH_KEYehstorbandmgmt.h 다음과 같이 선언됩니다.

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

입력 버퍼 길이

ACTIVATE_REVERT_PARAMETERS 구조체의 길이입니다.

출력 버퍼

없음.

출력 버퍼 길이

없음.

상태 블록

상태 필드에 다음 값 중 하나를 반환할 수 있습니다.

상태 값	묘사
STATUS_SUCCESS	스토리지 디바이스의 보안 기능이 비활성화되었습니다.
STATUS_INVALID_DEVICE_REQUEST	스토리지 디바이스는 대역 관리를 지원하지 않습니다.
STATUS_INVALID_BUFFER_SIZE	입력 버퍼 크기가 잘못되었습니다.
STATUS_INVALID_PARAMETER	입력 버퍼의 정보가 잘못되었습니다.
STATUS_ACCESS_DENIED	인증 키가 잘못되었습니다. 비활성화가 거부되었습니다.
STATUS_DEVICE_CONFIGURATION_ERROR	시스템에서 지원되는 모드에서 디바이스를 구성할 수 없습니다.
STATUS_IO_DEVICE_ERROR	통신이 실패했습니다. 스토리지 디바이스가 보안 프로토콜과 호환되지 않을 수 있습니다.
STATUS_INVALID_DEVICE_STATE	스토리지 디바이스가 활성화되지 않았습니다.

발언

IOCTL_EHSTOR_BANDMGMT_REVERT 요청에서 성공적으로 반환되면 스토리지 디바이스가 비활성 보안 상태로 돌아가고 IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES 및 IOCTL_EHSTOR_BANDMGMT_ACTIVATE제외한 모든 대역 관리 IOCTL을 사용할 수 없게 됩니다.

요구 사항

요구	값
지원되는 최소 클라이언트	Windows 8부터 사용 가능
헤더	ehstorbandmgmt.h(EhStorBandMgmt.h 포함)

참고 항목

IOCTL_EHSTOR_BANDMGMT_ACTIVATE

IOCTL_EHSTOR_BANDMGMT_QUERY_CAPABILITIES

다음을 통해 공유