Fonction FindActCtxSectionStringA (winbase.h)

  • Article

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és au; doit être null.

[in] ulSectionId

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

Voici des 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ère de recherche.

[out] ReturnedData

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

Valeur retournée

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 les méthodes COM. Les applications ne doivent pas appeler directement cette fonction.

Notes

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. La combinaison 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.

Configuration requise

   
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête winbase.h (inclure Windows.h)
Bibliothèque Kernel32.lib
DLL Kernel32.dll

Voir aussi

ACTCTX_SECTION_KEYED_DATA

FindActCtxSectionGuid