Bagikan melalui

Fungsi NtCreateLowBoxToken

  • Artikel

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

Lihat juga

NtCompareTokens