IOCTL_EHSTOR_DRIVER_PERFORM_AUTHZ IOCTL (ehstorioctl.h)
IOCTL_EHSTOR_DRIVER_PERFORM_AUTHZ отправляется драйвером класса расширенного хранилища (EHSTOR) драйвером silo для запуска проверки подлинности по запросу или отмены проверки подлинности.
Основной код
Входной буфер
Входной буфер в Irp->AssociatedIrp.SystemBuffer должен содержать структуру AUTHZ_STATE, которая указывает тип операции проверки подлинности для выполнения. AUTHZ_STATE объявлен в ehstorioctl.h следующим образом.
typedef struct _AUTHZ_STATE
{
ULONG AuthzState;
} AUTHZ_STATE;
Значение AuthzState указывает операцию проверки подлинности. Это один из следующих вариантов.
| Ценность | Описание |
|---|---|
| 0 | Выполните деавтоентику по запросу. |
| AUTHZSTATE_AUTHENTICATE | Выполните проверку подлинности по запросу. |
| AUTHZSTATE_CLEAR_AUTHKEY_CACHE | Выполните отмену проверки подлинности по запросу и очистку кэшированных ключей проверки подлинности. |
Длина входного буфера
Длина структуры AUTHZ_STATE.
Выходной буфер
Никакой.
Длина выходного буфера
Никакой.
Блок состояния
STATUS_SUCCESS возвращается в поле состояния драйвером сило, если состояние проверки подлинности изменено. В противном случае возвращается STATUS_UNSUCCESSFUL.
Замечания
Этот IOCTL отправляется EHSTOR драйверу silo, который поддерживает проверку подлинности по запросу. Драйвер silo уведомляет EHSTOR об этой возможности в предыдущем запросе IOCTL_EHSTOR_DRIVER_REPORT_CAPABILITIES с флагом CAP_ON_DEMAND_AUTHENTICATION, установленным в возможности члена SILO_DRIVER_CAPABILITES.
В ответ на этот IOCTL драйвер silo выполняет проверку подлинности или отмену проверки подлинности для устройства. Для подключенных устройств драйвер silo будет зависеть от указанной операции в системном буфере, разблокировать или заблокировать максимальное количество полос для операций чтения и записи.
Если драйвер silo не выполнит запрошенную операцию, он не изменит состояние проверки подлинности устройства.
Если элемент AUTHZ_STATE AuthzState имеет значение AUTHZSTATE_CLEAR_AUTHKEY_CACHE, драйвер silo очищает кэш ключей проверки подлинности в дополнение к отмене проверки подлинности. AUTHZSTATE_CLEAR_AUTHKEY_CACHE устанавливается при завершении работы системы или гибернации. Это предотвращает наличие кэша ключей в файле гибернации.
Если устройство поддерживает несколько силосов, проверка подлинности по каждому из них является монопольной. Операция проверки подлинности одним драйвером silo не влияет на состояние проверки подлинности, заданное другим драйвером silo.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Доступно начиная с Windows 8 |
| заголовка | ehstorioctl.h (include EhStorIoctl.h) |