struktur ACTCTX_SECTION_KEYED_DATA (winbase.h)

Artikel
08/27/2023

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)

Lihat juga

ACTCTX

FindActCtxSectionGuid

FindActCtxSectionString

Bagikan melalui