Bagikan melalui

Fungsi CreateActCtxA (winbase.h)

  • Artikel

Fungsi CreateActCtx membuat konteks aktivasi.

Sintaksis

HANDLE CreateActCtxA(
  [in, out] PCACTCTXA pActCtx
);

Parameter

[in, out] pActCtx

Arahkan ke struktur ACTCTX yang berisi informasi tentang konteks aktivasi yang akan dibuat.

Mengembalikan nilai

Jika fungsi berhasil, fungsi akan 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 .

Komentar

Atur bit yang tidak terdefinisi dalam dwFlags ACTCTX ke 0. Jika bit yang tidak ditentukan 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.

Nota

Header winbase.h mendefinisikan CreateActCtx sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosedur 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

Syarat Nilai
klien minimum yang didukung Windows XP [hanya aplikasi desktop]
server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Platform Target Windows
Header winbase.h (termasuk Windows.h)
Pustaka Kernel32.lib
DLL Kernel32.dll

Lihat juga

ACTCTX