Fonction FindActCtxSectionGuid (winbase.h)

Article
03/03/2024

La fonction FindActCtxSectionGuid récupère des informations sur un GUID spécifique dans le contexte d’activation actuel et retourne une structure ACTCTX_SECTION_KEYED_DATA .

Syntaxe

BOOL FindActCtxSectionGuid(
  [in]  DWORD                      dwFlags,
  [in]  const GUID                 *lpExtensionGuid,
  [in]  ULONG                      ulSectionId,
  [in]  const GUID                 *lpGuidToFind,
  [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 du contexte d’activation dans lequel rechercher le GUID spécifié.

Les identificateurs de section GUID valides sont les suivants :

ACTIVATION_CONTEXT_SECTION_COM_SERVER_REDIRECTION
ACTIVATION_CONTEXT_SECTION_COM_INTERFACE_REDIRECTION
ACTIVATION_CONTEXT_SECTION_COM_TYPE_LIBRARY_REDIRECTION

Voici un identificateur de section GUID valide commençant par Windows Server 2003 et Windows XP avec SP1 :

ACTIVATION_CONTEXT_SECTION_CLR_SURROGATES

[in] lpGuidToFind

Pointeur vers un GUID à utiliser comme critère de recherche.

[out] ReturnedData

Pointeur vers une structure ACTCTX_SECTION_KEYED_DATA à remplir avec les informations GUID 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.

Configuration requise

Condition requise	Valeur
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

FindActCtxSectionString

Partager via