Fungsi panggilan balik SpGetContextTokenFn (ntsecpkg.h)

Mendapatkan token untuk meniru. Fungsi SpGetContextToken digunakan oleh fungsi SSPI ImpersonateSecurityContext untuk mendapatkan token yang akan ditiru.

Sintaks

SpGetContextTokenFn Spgetcontexttokenfn;

NTSTATUS Spgetcontexttokenfn(
  [in]  LSA_SEC_HANDLE ContextHandle,
  [out] PHANDLE ImpersonationToken
)
{...}

Parameter

[in] ContextHandle

Handel ke konteks untuk meniru.

[out] ImpersonationToken

Penunjuk yang menerima handel ke token untuk konteks yang ditentukan. Kembalikan handel ke token tanpa terlebih dahulu menduplikasi handel atau token.

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
SEC_E_INVALID_HANDLE	Handel tidak valid.

Keterangan

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

Penunjuk ke fungsi SpGetContextToken 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

ImpersonateSecurityContext

SECPKG_USER_FUNCTION_TABLE

SpUserModeInitialize