Fungsi CreateActCtxA (winbase.h)

  • Artikel

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

Lihat juga

ACTCTX