IOCTL_EHSTOR_DRIVER_PERFORM_AUTHZ IOCTL(ehstorioctl.h)
IOCTL_EHSTOR_DRIVER_PERFORM_AUTHZ EHSTOR(Enhanced Storage Class Driver)에서 사일로 드라이버로 전송되어 주문형 인증 또는 인증을 시작합니다.
주 코드
입력 버퍼
Irp-AssociatedIrp.SystemBuffer>의 입력 버퍼에는 수행할 인증 작업의 유형을 나타내는 AUTHZ_STATE 구조가 포함되어야 합니다. AUTHZ_STATE 다음과 같이 ehstorioctl.h 에 선언됩니다.
typedef struct _AUTHZ_STATE
{
ULONG AuthzState;
} AUTHZ_STATE;
AuthzState 값은 인증 작업을 지정합니다. 다음 중 하나입니다.
| 값 | Description |
|---|---|
| 0 | 주문형 인증을 수행합니다. |
| AUTHZSTATE_AUTHENTICATE | 주문형 인증을 수행합니다. |
| AUTHZSTATE_CLEAR_AUTHKEY_CACHE | 주문형 인증 해제 및 캐시된 인증 키 지우기 수행 |
입력 버퍼 길이
AUTHZ_STATE 구조체의 길이입니다.
출력 버퍼
없음
출력 버퍼 길이
없음
상태 블록
STATUS_SUCCESS 인증 상태가 변경되면 사일로 드라이버에 의해 상태 필드에 반환됩니다. 그렇지 않으면 STATUS_UNSUCCESSFUL 반환됩니다.
설명
이 IOCTL은 EHSTOR에서 주문형 인증을 지원하는 사일로 드라이버로 전송됩니다. 사일로 드라이버는 SILO_DRIVER_CAPABILITES Capabilities 멤버에 설정된 CAP_ON_DEMAND_AUTHENTICATION 플래그를 사용하여 이전 IOCTL_EHSTOR_DRIVER_REPORT_CAPABILITIES 요청에서 이 기능을 EHSTOR에 알린다.
이 IOCTL에 대한 응답으로 사일로 드라이버는 디바이스에 대한 인증 또는 인증을 수행합니다. 줄무늬 디바이스의 경우 사일로 드라이버는 시스템 버퍼에서 지정된 작업에 따라 읽기 및 쓰기에 대해 가능한 한 많은 대역을 잠금 해제하거나 잠급니다.
사일로 드라이버가 요청된 작업을 수행하지 못하면 디바이스의 인증 상태가 변경되지 않습니다.
AUTHZ_STATEAuthzState 멤버가 AUTHZSTATE_CLEAR_AUTHKEY_CACHE 설정된 경우 사일로 드라이버는 인증을 취소하는 것 외에도 인증 키 캐시를 지웁니다. 시스템이 종료되거나 최대 절전 모드인 경우 AUTHZSTATE_CLEAR_AUTHKEY_CACHE 설정됩니다. 이렇게 하면 최대 절전 모드 파일에 키 캐시가 존재하지 않습니다.
디바이스가 여러 사일로를 지원하는 경우 각 사일로에 의한 인증은 배타적입니다. 한 사일로 드라이버의 인증 작업은 다른 사일로 드라이버가 설정한 인증 상태에 영향을 주지 않습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 8 시작 |
| 머리글 | ehstorioctl.h(EhStorIoctl.h 포함) |