Fungsi FindActCtxSectionGuid (winbase.h)

Fungsi FindActCtxSectionGuid mengambil informasi tentang GUID tertentu dalam konteks aktivasi saat ini dan mengembalikan struktur ACTCTX_SECTION_KEYED_DATA .

Sintaks

BOOL FindActCtxSectionGuid(
  [in]  DWORD                      dwFlags,
  [in]  const GUID                 *lpExtensionGuid,
  [in]  ULONG                      ulSectionId,
  [in]  const GUID                 *lpGuidToFind,
  [out] PACTCTX_SECTION_KEYED_DATA ReturnedData
);

Parameter

[in] dwFlags

Bendera yang menentukan bagaimana fungsi ini beroperasi. Hanya bendera berikut yang saat ini ditentukan.

Nilai	Makna
FIND_ACTCTX_SECTION_KEY_RETURN_HACTCTX	Fungsi ini mengembalikan handel konteks aktivasi tempat data pengalihan ditemukan di anggota hActCtx dari struktur ACTCTX_SECTION_KEYED_DATA . Pemanggil harus menggunakan ReleaseActCtx untuk merilis konteks aktivasi ini.

[in] lpExtensionGuid

Dipesan; harus null.

[in] ulSectionId

Pengidentifikasi bagian konteks aktivasi untuk mencari GUID yang ditentukan.

Berikut ini adalah pengidentifikasi bagian GUID yang valid:

• ACTIVATION_CONTEXT_SECTION_COM_SERVER_REDIRECTION
• ACTIVATION_CONTEXT_SECTION_COM_INTERFACE_REDIRECTION
• ACTIVATION_CONTEXT_SECTION_COM_TYPE_LIBRARY_REDIRECTION

Berikut ini adalah pengidentifikasi bagian GUID yang valid yang dimulai dengan Windows Server 2003 dan Windows XP dengan SP1:

• ACTIVATION_CONTEXT_SECTION_CLR_SURROGATES

[in] lpGuidToFind

Penunjuk ke GUID yang akan digunakan sebagai kriteria pencarian.

[out] ReturnedData

Arahkan ke struktur ACTCTX_SECTION_KEYED_DATA untuk diisi dengan informasi GUID yang diminta.

Nilai kembali

Jika fungsi berhasil, fungsi akan mengembalikan TRUE. Jika tidak, ia mengembalikan FALSE.

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

Fungsi ini hanya boleh dipanggil oleh fungsi API berdampingan atau metode COM. Aplikasi tidak boleh langsung memanggil fungsi ini.

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_SECTION_KEYED_DATA

FindActCtxSectionString