Fungsi NtCreateLowBoxToken
Fungsi NtCreateLowBoxToken membuat objek token LowBox (AppContainer) berdasarkan token akses yang ada dan mengembalikan handel yang dibuka untuk akses ke token tersebut.
Sintaks
NTSTATUS NTAPI NtCreateLowBoxToken(
_Out_ PHANDLE TokenHandle,
_In_ HANDLE ExistingTokenHandle,
_In_ ACCESS_MASK DesiredAccess,
_in_ POBJECT_ATTRIBUTES ObjectAttributes,
_in_ PSID PackageSid,
_in_ ULONG CapabilityCount,
_in_ PSID_AND_ATTRIBUTES Capabilities,
_in_ ULONG HandleCount,
_in_ HANDLE* Handles
);
Parameter
TokenHandle [out]
Mengembalikan handel token LowBox yang baru dibuat.
ExistingTokenHandle [in]
Handel token yang dibuat yang ada. Token harus terbuka untuk akses TOKEN_QUERY .
DesiredAccess [in]
ACCESS_MASK yang menunjukkan jenis akses mana yang akan diberikan handel ke objek baru.
ObjectAttributes [in, Optional]
Menunjuk ke struktur data OBJECT_ATTRIBUTES standar.
PackageSid [in]
Paket tempat token ini akan dimiliki. Ini harus menunjuk ke SID yang valid yang harus menjadi anggota grup SID Paket LowBox.
CapabilityCount [in]
Jumlah kemampuan untuk disertakan pada token.
Capabilities [in, Optional]
Struktur SID_AND_ATTRIBUTES yang berisi SID kemampuan untuk disertakan pada token.
HandleCount [in]
Jumlah handel yang akan disertakan pada token.
Handles [in, Optional]
Menangani direktori objek bernama untuk AppContainer.
Nilai kembali
Jika fungsi berhasil, fungsi akan mengembalikan STATUS_SUCCESS.
Jika fungsi gagal, fungsi mengembalikan kode kesalahan NTSTATUS . Lihat nilai NTSTATUS untuk daftar kode kesalahan dan nilainya.
Keterangan
API ini hanya dapat dipanggil dengan proses IL sedang atau lebih tinggi.
Fungsi ini tidak memiliki pustaka impor atau file header terkait; Anda harus memanggilnya menggunakan fungsi LoadLibrary dan GetProcAddress .
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows 8 [khusus aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2012 [hanya aplikasi desktop] |
| DLL | Ntdll.dll |