IOCTL_EHSTOR_DRIVER_PERFORM_AUTHZ IOCTL (ehstorioctl.h)
IOCTL_EHSTOR_DRIVER_PERFORM_AUTHZ dikirim oleh Enhanced Storage Class Driver (EHSTOR) ke driver silo untuk memulai autentikasi sesuai permintaan atau deautentikasi.
Kode utama
Buffer input
Buffer input di Irp-AssociatedIrp.SystemBuffer> harus berisi struktur AUTHZ_STATE yang menunjukkan jenis operasi autentikasi yang akan dilakukan. AUTHZ_STATE dinyatakan dalam ehstorioctl.h sebagai berikut.
typedef struct _AUTHZ_STATE
{
ULONG AuthzState;
} AUTHZ_STATE;
Nilai AuthzState menentukan operasi autentikasi. Ini adalah salah satu dari berikut ini.
| Nilai | Deskripsi |
|---|---|
| 0 | Lakukan deauthentikasi sesuai permintaan. |
| AUTHZSTATE_AUTHENTICATE | Lakukan autentikasi sesuai permintaan. |
| AUTHZSTATE_CLEAR_AUTHKEY_CACHE | Lakukan deautentikasi sesuai permintaan dan hapus kunci autentikasi cache. |
Panjang buffer input
Panjang struktur AUTHZ_STATE .
Buffer output
Tidak ada.
Panjang buffer output
Tidak ada.
Blok status
STATUS_SUCCESS dikembalikan di bidang Status oleh driver silo jika status autentikasi diubah. Jika tidak, STATUS_UNSUCCESSFUL dikembalikan.
Keterangan
IOCTL ini dikirim oleh EHSTOR ke driver silo yang mendukung autentikasi sesuai permintaan. Driver silo memberi tahu EHSTOR tentang kemampuan ini dalam permintaan IOCTL_EHSTOR_DRIVER_REPORT_CAPABILITIES sebelumnya dengan bendera CAP_ON_DEMAND_AUTHENTICATION yang diatur dalam anggota KemampuanSILO_DRIVER_CAPABILITES.
Menanggapi IOCTL ini, driver silo melakukan autentikasi atau deautentikasi untuk perangkat. Untuk perangkat bersalur, driver silo akan, tergantung pada operasi yang ditentukan di buffer sistem, buka kunci atau kunci pita sebanyak mungkin untuk baca dan tulis.
Jika driver silo gagal melakukan operasi yang diminta, itu tidak akan mengubah status autentikasi perangkat.
Jika anggota AuthzStatedari AUTHZ_STATE diatur ke AUTHZSTATE_CLEAR_AUTHKEY_CACHE, maka driver silo menghapus cache kunci autentikasinya selain deautentikasi. AUTHZSTATE_CLEAR_AUTHKEY_CACHE diatur ketika sistem dimatikan atau berhibernasi. Ini mencegah keberadaan cache kunci dalam file hibernasi.
Jika perangkat mendukung beberapa silo, autentikasi oleh setiap silo bersifat eksklusif. Operasi autentikasi oleh satu driver silo tidak memengaruhi status autentikasi yang ditetapkan oleh driver silo lain.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Tersedia dimulai dengan Windows 8 |
| Header | ehstorioctl.h (termasuk EhStorIoctl.h) |