Función FindActCtxSectionGuid (winbase.h)

  • Artículo

La función FindActCtxSectionGuid recupera información sobre un GUID específico en el contexto de activación actual y devuelve una estructura de ACTCTX_SECTION_KEYED_DATA .

Sintaxis

BOOL FindActCtxSectionGuid(
  [in]  DWORD                      dwFlags,
  [in]  const GUID                 *lpExtensionGuid,
  [in]  ULONG                      ulSectionId,
  [in]  const GUID                 *lpGuidToFind,
  [out] PACTCTX_SECTION_KEYED_DATA ReturnedData
);

Parámetros

[in] dwFlags

Marcas que determinan cómo funciona esta función. Actualmente solo se define la marca siguiente.

Valor Significado
FIND_ACTCTX_SECTION_KEY_RETURN_HACTCTX
 Esta función devuelve el identificador de contexto de activación donde se encontraron los datos de redireccionamiento en el miembro hActCtx de la estructura ACTCTX_SECTION_KEYED_DATA . El llamador debe usar ReleaseActCtx para liberar este contexto de activación.

[in] lpExtensionGuid

Reservados; debe ser null.

[in] ulSectionId

Identificador de la sección del contexto de activación en el que se va a buscar el GUID especificado.

A continuación se muestran identificadores de sección GUID válidos:

  • ACTIVATION_CONTEXT_SECTION_COM_SERVER_REDIRECTION
  • ACTIVATION_CONTEXT_SECTION_COM_INTERFACE_REDIRECTION
  • ACTIVATION_CONTEXT_SECTION_COM_TYPE_LIBRARY_REDIRECTION
A continuación se muestra un identificador de sección GUID válido a partir de Windows Server 2003 y Windows XP con SP1:
  • ACTIVATION_CONTEXT_SECTION_CLR_SURROGATES

[in] lpGuidToFind

Puntero a un GUID que se usará como criterio de búsqueda.

[out] ReturnedData

Puntero a una estructura de ACTCTX_SECTION_KEYED_DATA que se rellenará con la información de GUID solicitada.

Valor devuelto

Si la función se ejecuta correctamente, devuelve TRUE. De lo contrario, devuelve FALSE.

Esta función establece errores que se pueden recuperar llamando a GetLastError. Para obtener un ejemplo, consulte Recuperación del código de Last-Error. Para obtener una lista completa de los códigos de error, consulte Códigos de error del sistema.

Comentarios

Las funciones de API en paralelo o los métodos COM solo deben llamar a esta función. Las aplicaciones no deben llamar directamente a esta función.

Requisitos

Requisito Value
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado winbase.h (incluya Windows.h)
Library Kernel32.lib
Archivo DLL Kernel32.dll

Vea también

ACTCTX_SECTION_KEYED_DATA

FindActCtxSectionString