FindActCtxSectionGuid-Funktion (winbase.h)

Artikel
03/03/2024

Die FindActCtxSectionGuid-Funktion ruft Informationen zu einer bestimmten GUID im aktuellen Aktivierungskontext ab und gibt eine ACTCTX_SECTION_KEYED_DATA-Struktur zurück.

Syntax

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

Flags, die bestimmen, wie diese Funktion ausgeführt werden soll. Derzeit ist nur das folgende Flag definiert.

Wert	Bedeutung
FIND_ACTCTX_SECTION_KEY_RETURN_HACTCTX	Diese Funktion gibt das Aktivierungskontexthandle zurück, in dem die Umleitungsdaten im hActCtx-Member der ACTCTX_SECTION_KEYED_DATA-Struktur gefunden wurden. Der Aufrufer muss ReleaseActCtx verwenden, um diesen Aktivierungskontext freizugeben.

[in] lpExtensionGuid

Reserviert; muss NULL sein.

[in] ulSectionId

Bezeichner des Abschnitts des Aktivierungskontexts, in dem nach der angegebenen GUID gesucht werden soll.

Im Folgenden sind gültige GUID-Abschnittsbezeichner aufgeführt:

ACTIVATION_CONTEXT_SECTION_COM_SERVER_REDIRECTION
ACTIVATION_CONTEXT_SECTION_COM_INTERFACE_REDIRECTION
ACTIVATION_CONTEXT_SECTION_COM_TYPE_LIBRARY_REDIRECTION

Im Folgenden finden Sie einen gültigen GUID-Abschnittsbezeichner, der mit Windows Server 2003 und Windows XP mit SP1 beginnt:

ACTIVATION_CONTEXT_SECTION_CLR_SURROGATES

[in] lpGuidToFind

Zeiger auf eine GUID, die als Suchkriterien verwendet werden soll.

[out] ReturnedData

Zeiger auf eine ACTCTX_SECTION_KEYED_DATA Struktur, die mit den angeforderten GUID-Informationen ausgefüllt werden soll.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt sie TRUE zurück. Andernfalls wird FALSE zurückgegeben.

Diese Funktion legt Fehler fest, die durch Aufrufen von GetLastError abgerufen werden können. Ein Beispiel finden Sie unter Abrufen des Last-Error Codes. Eine vollständige Liste der Fehlercodes finden Sie unter Systemfehlercodes.

Hinweise

Diese Funktion sollte nur von den parallelen API-Funktionen oder COM-Methoden aufgerufen werden. Anwendungen sollten diese Funktion nicht direkt aufrufen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winbase.h (einschließlich Windows.h)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll

Siehe auch

ACTCTX_SECTION_KEYED_DATA

FindActCtxSectionString

Freigeben über