FindActCtxSectionStringA, fonction (winbase.h)

Article
11/20/2024

La fonction FindActCtxSectionString récupère des informations sur une chaîne spécifique dans le contexte d’activation actuel et retourne une structure ACTCTX_SECTION_KEYED_DATA.

Syntaxe

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

Paramètres

[in] dwFlags

Indicateurs qui déterminent le fonctionnement de cette fonction. Seul l’indicateur suivant est actuellement défini.

Valeur	Signification
FIND_ACTCTX_SECTION_KEY_RETURN_HACTCTX	Cette fonction retourne le handle de contexte d’activation où les données de redirection ont été trouvées dans le membre hActCtx de la structure ACTCTX_SECTION_KEYED_DATA. L’appelant doit utiliser releaseActCtx pour libérer ce contexte d’activation.

[in] lpExtensionGuid

Réservé; doit être null.

[in] ulSectionId

Identificateur de la section chaîne du contexte d’activation dans lequel rechercher la chaîne spécifique.

Voici les identificateurs de section de chaîne valides :

ACTIVATION_CONTEXT_SECTION_ASSEMBLY_INFORMATION
ACTIVATION_CONTEXT_SECTION_DLL_REDIRECTION
ACTIVATION_CONTEXT_SECTION_WINDOW_CLASS_REDIRECTION
ACTIVATION_CONTEXT_SECTION_COM_PROGID_REDIRECTION

[in] lpStringToFind

Pointeur vers une chaîne terminée par null à utiliser comme critères de recherche.

[out] ReturnedData

Pointeur vers une structure ACTCTX_SECTION_KEYED_DATA à remplir avec les informations de chaîne demandées.

Valeur de retour

Si la fonction réussit, elle retourne TRUE. Sinon, elle retourne FALSE.

Cette fonction définit les erreurs qui peuvent être récupérées en appelant GetLastError. Pour obtenir un exemple, consultez Récupération du code Last-Error. Pour obtenir la liste complète des codes d’erreur, consultez Codes d’erreur système.

Remarques

Cette fonction ne doit être appelée que par les fonctions d’API côte à côte ou par les méthodes COM. Les applications ne doivent pas appeler directement cette fonction.

Note

L’en-tête winbase.h définit FindActCtxSectionString comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows XP [applications de bureau uniquement]
serveur minimum pris en charge	Windows Server 2003 [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	winbase.h (inclure Windows.h)
bibliothèque	Kernel32.lib
DLL	Kernel32.dll

Voir aussi

ACTCTX_SECTION_KEYED_DATA

FindActCtxSectionGuid

Partager via