Fungsi CreateActCtxA (winbase.h)
Fungsi CreateActCtx membuat konteks aktivasi.
Sintaks
HANDLE CreateActCtxA(
[in, out] PCACTCTXA pActCtx
);
Parameter
[in, out] pActCtx
Arahkan ke struktur ACTCTX yang berisi informasi tentang konteks aktivasi yang akan dibuat.
Nilai kembali
Jika fungsi berhasil, fungsi mengembalikan handel ke konteks aktivasi yang dikembalikan. Jika tidak, ia mengembalikan INVALID_HANDLE_VALUE.
Fungsi ini mengatur kesalahan yang dapat diambil dengan memanggil GetLastError. Misalnya, lihat Mengambil Kode Last-Error. Untuk daftar lengkap kode kesalahan, lihat Kode Kesalahan Sistem.
Keterangan
Atur bit yang tidak terdefinisi dalam dwFlagsdari ACTCTX ke 0. Jika bit yang tidak terdefinisi tidak diatur ke 0, panggilan ke CreateActCtx yang membuat konteks aktivasi gagal dan mengembalikan kode kesalahan parameter yang tidak valid. Handel yang dikembalikan dari CreateActCtx diteruskan dalam panggilan ke ActivateActCtx untuk mengaktifkan konteks untuk utas saat ini.
Catatan
Header winbase.h mendefinisikan CreateActCtx sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.
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 | winbase.h (termasuk Windows.h) |
| Pustaka | Kernel32.lib |
| DLL | Kernel32.dll |