FindActCtxSectionStringA-Funktion (winbase.h)

Artikel
11/20/2024

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

Syntax

BOOL FindActCtxSectionStringA(
  [in]  DWORD                      dwFlags,
  [in]  const GUID                 *lpExtensionGuid,
  [in]  ULONG                      ulSectionId,
  [in]  LPCSTR                     lpStringToFind,
  [out] PACTCTX_SECTION_KEYED_DATA ReturnedData
);

Parameter

[in] dwFlags

Flags, die bestimmen, wie diese Funktion funktioniert. Derzeit ist nur das folgende Flag definiert.

Wert	Bedeutung
FIND_ACTCTX_SECTION_KEY_RETURN_HACTCTX	Diese Funktion gibt das Aktivierungskontexthandle zurück, bei dem die Umleitungsdaten im hActCtx- Element 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 Zeichenfolgenabschnitts des Aktivierungskontexts, in dem nach der spezifischen Zeichenfolge gesucht werden soll.

Es folgen gültige Zeichenfolgenabschnittsbezeichner:

ACTIVATION_CONTEXT_SECTION_ASSEMBLY_INFORMATION
ACTIVATION_CONTEXT_SECTION_DLL_REDIRECTION
ACTIVATION_CONTEXT_SECTION_WINDOW_CLASS_REDIRECTION
ACTIVATION_CONTEXT_SECTION_COM_PROGID_REDIRECTION

[in] lpStringToFind

Zeigen Sie auf eine mit Null beendete Zeichenfolge, die als Suchkriterien verwendet werden soll.

[out] ReturnedData

Zeigen Sie auf eine ACTCTX_SECTION_KEYED_DATA Struktur, die mit den angeforderten Zeichenfolgeninformationen ausgefüllt werden soll.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird TRUE-zurückgegeben. Andernfalls wird FALSE-zurückgegeben.

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

Bemerkungen

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

Anmerkung

Der winbase.h-Header definiert FindActCtxSectionString als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows XP [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	winbase.h (enthalten Windows.h)
Library	Kernel32.lib
DLL-	Kernel32.dll

Siehe auch

ACTCTX_SECTION_KEYED_DATA

FindActCtxSectionGuid

Freigeben über