Fungsi ExportSecurityContext (sspi.h)

Fungsi ExportSecurityContext membuat representasi berseri dari konteks keamanan yang nantinya dapat diimpor ke proses yang berbeda dengan memanggil
ImportSecurityContext. Proses yang mengimpor konteks keamanan harus berjalan pada komputer yang sama dengan proses yang disebut ExportSecurityContext.

Sintaks

KSECDDDECLSPEC SECURITY_STATUS SEC_ENTRY ExportSecurityContext(
  [in]            PCtxtHandle phContext,
  [in]            ULONG       fFlags,
  [out]           PSecBuffer  pPackedContext,
  [out, optional] void        **pToken
);

Parameter

[in] phContext

Handel konteks keamanan yang akan diekspor.

[in] fFlags

Parameter ini bisa menjadi kombinasi bitwise-OR dari nilai berikut.

Nilai	Makna
SECPKG_CONTEXT_EXPORT_RESET_NEW 1 (0x1)	Konteks keamanan baru diatur ulang ke status awalnya.
SECPKG_CONTEXT_EXPORT_DELETE_OLD 2 (0x2)	Konteks keamanan lama dihapus.
SECPKG_CONTEXT_EXPORT_TO_KERNEL 4 (0x4)	Nilai ini tidak didukung. Windows Server 2003 dan Windows XP/2000: Konteks keamanan akan diekspor ke kernel. Nilai ini hanya didukung dalam mode kernel Schannel.

[out] pPackedContext

Penunjuk ke buffer jenis SECBUFFER_EMPTY yang menerima konteks keamanan berseri . Setelah Anda selesai menggunakan konteks ini, bebaskan dengan memanggil fungsi FreeContextBuffer .

[out, optional] pToken

Penunjuk untuk menerima handel token konteks.

Setelah Anda selesai menggunakan token pengguna, lepaskan handel dengan memanggil fungsi CloseHandle .

Nilai kembali

Jika fungsi berhasil, fungsi akan mengembalikan SEC_E_OK.

Jika fungsi gagal, fungsi akan mengembalikan salah satu kode kesalahan berikut.

Menampilkan kode	Deskripsi
SEC_E_INSUFFICIENT_MEMORY	Tidak tersedia cukup memori untuk menyelesaikan tindakan yang diminta.
SEC_E_INVALID_HANDLE	Parameter phContext tidak menunjuk ke handel yang valid.
SEC_E_NOT_SUPPORTED	Mode kernel Schannel tidak mendukung fungsi ini.

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	sspi.h (termasuk Security.h)
Pustaka	Secur32.lib
DLL	Secur32.dll

Lihat juga

FreeContextBuffer

ImportSecurityContext

Fungsi SSPI