FindActCtxSectionGuid-Funktion (winbase.h)

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