Antarmuka IPrincipal (taskschd.h)
Menyediakan kredensial keamanan untuk prinsipal. Kredensial keamanan ini menentukan konteks keamanan untuk tugas yang terkait dengan prinsipal.
Warisan
Antarmuka IPrincipal mewarisi dari antarmuka IDispatch.
Metode
Antarmuka IPrincipal memiliki metode ini.
| IPrincipal::get_DisplayName Mendapatkan atau menetapkan nama prinsipal. (Dapatkan) |
| IPrincipal::get_GroupId Mendapatkan atau mengatur pengidentifikasi grup pengguna yang diperlukan untuk menjalankan tugas yang terkait dengan prinsipal. (Dapatkan) |
| IPrincipal::get_Id Mendapatkan atau mengatur pengidentifikasi utama. (Dapatkan) |
| IPrincipal::get_LogonType Mendapatkan atau mengatur metode masuk keamanan yang diperlukan untuk menjalankan tugas yang terkait dengan prinsipal. (Dapatkan) |
| IPrincipal::get_RunLevel Mendapatkan atau mengatur pengidentifikasi yang digunakan untuk menentukan tingkat hak istimewa yang diperlukan untuk menjalankan tugas yang terkait dengan prinsipal. (Dapatkan) |
| IPrincipal::get_UserId Mendapatkan atau mengatur pengidentifikasi pengguna yang diperlukan untuk menjalankan tugas yang terkait dengan prinsipal. (Dapatkan) |
| IPrincipal::p ut_DisplayName Mendapatkan atau menetapkan nama prinsipal. (Put) |
| IPrincipal::p ut_GroupId Mendapatkan atau mengatur pengidentifikasi grup pengguna yang diperlukan untuk menjalankan tugas yang terkait dengan prinsipal. (Put) |
| IPrincipal::p ut_Id Mendapatkan atau mengatur pengidentifikasi utama. (Put) |
| IPrincipal::p ut_LogonType Mendapatkan atau mengatur metode masuk keamanan yang diperlukan untuk menjalankan tugas yang terkait dengan prinsipal. (Put) |
| IPrincipal::p ut_RunLevel Mendapatkan atau mengatur pengidentifikasi yang digunakan untuk menentukan tingkat hak istimewa yang diperlukan untuk menjalankan tugas yang terkait dengan prinsipal. (Put) |
| IPrincipal::p ut_UserId Mendapatkan atau mengatur pengidentifikasi pengguna yang diperlukan untuk menjalankan tugas yang terkait dengan prinsipal. (Put) |
Keterangan
Saat menentukan akun, ingatlah untuk menggunakan garis miring terbelakang ganda dalam kode dengan benar untuk menentukan domain dan nama pengguna. Misalnya, gunakan DOMAIN\UserName untuk menentukan nilai untuk properti UserId .
Saat membaca atau menulis XML untuk tugas, kredensial keamanan untuk prinsipal ditentukan dalam elemen Utama dari skema Penjadwal Tugas.
Jika tugas terdaftar menggunakan alat baris perintah at.exe, dan antarmuka ini digunakan untuk mengambil informasi tentang tugas, maka properti LogonType akan mengembalikan 0, properti RunLevel akan mengembalikan 0, dan properti UserId akan mengembalikan NULL.
Contoh
Untuk informasi selengkapnya dan contoh kode untuk antarmuka ini, lihat Contoh Pemicu Waktu (C++) atau Contoh Pemicu Pendaftaran (C++).
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows Vista [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2008 [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | taskschd.h |