FindActCtxSectionStringA-Funktion (winbase.h)

Artikel
08/27/2023

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 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 Zeichenfolgenabschnitts des Aktivierungskontexts, in dem nach der spezifischen Zeichenfolge gesucht werden soll.

Im Folgenden sind gültige Zeichenfolgenabschnittsbezeichner aufgeführt:

ACTIVATION_CONTEXT_SECTION_ASSEMBLY_INFORMATION
ACTIVATION_CONTEXT_SECTION_DLL_REDIRECTION
ACTIVATION_CONTEXT_SECTION_WINDOW_CLASS_REDIRECTION
ACTIVATION_CONTEXT_SECTION_COM_PROGID_REDIRECTION

[in] lpStringToFind

Zeiger auf eine NULL-Zeichenfolge, die als Suchkriterien verwendet werden soll.

[out] ReturnedData

Zeiger auf eine ACTCTX_SECTION_KEYED_DATA Struktur, die mit den angeforderten Zeichenfolgeninformationen 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.

Hinweis

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

Anforderungen


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

FindActCtxSectionGuid

Share via