struktur ACTCTX_SECTION_KEYED_DATA (winbase.h)
Struktur ACTCTX_SECTION_KEYED_DATA digunakan oleh fungsi FindActCtxSectionString dan FindActCtxSectionGuid untuk mengembalikan informasi konteks aktivasi bersama dengan guid atau bagian konteks aktivasi bertag bilangan bulat 32-bit.
Sintaks
typedef struct tagACTCTX_SECTION_KEYED_DATA {
ULONG cbSize;
ULONG ulDataFormatVersion;
PVOID lpData;
ULONG ulLength;
PVOID lpSectionGlobalData;
ULONG ulSectionGlobalDataLength;
PVOID lpSectionBase;
ULONG ulSectionTotalLength;
HANDLE hActCtx;
ULONG ulAssemblyRosterIndex;
ULONG ulFlags;
ACTCTX_SECTION_KEYED_DATA_ASSEMBLY_METADATA AssemblyMetadata;
} ACTCTX_SECTION_KEYED_DATA, *PACTCTX_SECTION_KEYED_DATA;
Anggota
cbSize
Ukuran, dalam byte, dari struktur data kunci konteks aktivasi.
ulDataFormatVersion
Angka yang menunjukkan format data di bagian tempat kunci ditemukan. Klien harus memverifikasi bahwa versi format data seperti yang diharapkan daripada mencoba menginterpretasikan nilai format data yang tidak dikenal. Angka ini hanya diubah ketika perubahan besar yang tidak kompatibel dengan mundur ke format data bagian perlu dibuat. Versi format saat ini adalah 1.
lpData
Penunjuk ke data pengalihan yang ditemukan terkait dengan pengidentifikasi dan kunci bagian.
ulLength
Jumlah byte dalam struktur yang dimaksud oleh lpData. Perhatikan bahwa struktur data tumbuh dari waktu ke waktu; jangan mengakses anggota dalam data instans yang melampaui ulLength.
lpSectionGlobalData
Penunjuk yang dikembalikan ke struktur data khusus bagian yang global ke bagian konteks aktivasi tempat kunci ditemukan. Interpretasinya tergantung pada pengidentifikasi bagian yang diminta.
ulSectionGlobalDataLength
Jumlah byte di bagian blok data global yang disebutkan oleh lpSectionGlobalData.
Perhatikan bahwa struktur data tumbuh dari waktu ke waktu dan Anda mungkin menerima blok data konteks aktivasi format lama; jangan mengakses anggota di bagian data global yang melampaui ulSectionGlobalDataLength.
lpSectionBase
Penunjuk ke dasar bagian tempat kunci ditemukan. Beberapa data instans berisi offset relatif terhadap alamat dasar bagian, dalam hal ini nilai pointer digunakan.
ulSectionTotalLength
Jumlah byte untuk seluruh bagian mulai dari lpSectionBase. Dapat digunakan untuk memverifikasi bahwa pasangan offset/panjang, yang ditentukan sebagai relatif terhadap basis bagian sepenuhnya terkandung dalam bagian.
hActCtx
Tangani ke konteks aktivasi tempat kunci ditemukan. Pertama, konteks aktivasi aktif untuk utas dicari, diikuti oleh konteks aktivasi proses-default dan kemudian konteks aktivasi default yang kompatibel dengan sistem. Anggota ini menunjukkan konteks aktivasi mana yang berisi bagian dan kunci yang diminta. Ini hanya dikembalikan jika bendera FIND_ACTCTX_SECTION_KEY_RETURN_HACTCTX diteruskan.
Perhatikan bahwa ketika ini dikembalikan, pemanggil harus memanggil ReleaseActCtx() pada handel konteks aktivasi yang dikembalikan ke merilis sumber daya sistem ketika semua referensi lain ke konteks aktivasi telah dirilis.
ulAssemblyRosterIndex
Nomor kardinal assembly dalam konteks aktivasi yang memberikan informasi pengalihan yang ditemukan. Nilai ini dapat disajikan ke QueryActCtxW untuk informasi selengkapnya tentang rakitan yang berkontribusi.
ulFlags
AssemblyMetadata
Keterangan
Penelepon harus menginisialisasi struktur ACTCTX_SECTION_KEYED_DATA seperti:
"ACTCTX_SECTION_KEYED_DATA ditanya = { sizeof(askd) };"
yang menginisialisasi semua anggota ke nol/null kecuali bidang ukuran yang diatur dengan benar.
Persyaratan
| Klien minimum yang didukung | Windows XP [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows Server 2003 [hanya aplikasi desktop] |
| Header | winbase.h (termasuk Windows.h) |