Fungsi panggilan balik SpInitUserModeContextFn (ntsecpkg.h)

  • Artikel

Fungsi SpInitUserModeContext membuat konteks keamanan mode pengguna dari konteks mode Otoritas Keamanan Lokal (LSA) yang dikemas.

Sintaks

SpInitUserModeContextFn Spinitusermodecontextfn;

NTSTATUS Spinitusermodecontextfn(
  [in] LSA_SEC_HANDLE ContextHandle,
  [in] PSecBuffer PackedContext
)
{...}

Parameter

[in] ContextHandle

Handel ke konteks mode LSA yang dikembalikan dari fungsi SpInitLsaModeContext atau SpAcceptLsaModeContext .

[in] PackedContext

Penunjuk ke struktur SecBuffer yang berisi data konteks berseri . Gunakan fungsi FreeContextBuffer untuk mengosongkan memori yang dialokasikan untuk struktur ini.

Nilai kembali

Jika fungsi berhasil, kembalikan STATUS_SUCCESS.

Jika fungsi gagal, kembalikan kode NTSTATUS yang menunjukkan alasan gagalnya. Berikut ini mencantumkan alasan umum kegagalan dan kode kesalahan yang harus dikembalikan fungsi.

Menampilkan kode Deskripsi
STATUS_INSUFFICIENT_RESOURCES
 Memori tidak cukup untuk membuat konteks.

Keterangan

Fungsi SpInitUserModeContext dipanggil setelah konteks keamanan dibuat oleh paket keamanan, jika parameter MappedContext dari SpInitLsaModeContext atau SpAcceptLsaModeContext diatur ke TRUE. Data konteks khusus paket harus berisi informasi yang diperlukan untuk menentukan fungsi mana yang menghasilkan panggilan ke SpInitUserModeContext.

SSP/APs harus mengimplementasikan fungsi SpInitUserModeContext ; namun, nama aktual yang diberikan untuk implementasi terserah pengembang.

Penunjuk ke fungsi SpInitUserModeContext tersedia dalam struktur SECPKG_USER_FUNCTION_TABLE yang diterima dari fungsi SpUserModeInitialize .

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows XP [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Target Platform Windows
Header ntsecpkg.h

Lihat juga

SECPKG_USER_FUNCTION_TABLE

SpAcceptLsaModeContext

SpInitLsaModeContext

SpUserModeInitialize