Función FindActCtxSectionGuid (winbase.h)

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