Compartir a través de

Función FindActCtxSectionStringA (winbase.h)

  • Artículo

La función FindActCtxSectionString recupera información sobre una cadena específica en el contexto de activación actual y devuelve una estructura ACTCTX_SECTION_KEYED_DATA.

Sintaxis

BOOL FindActCtxSectionStringA(
  [in]  DWORD                      dwFlags,
  [in]  const GUID                 *lpExtensionGuid,
  [in]  ULONG                      ulSectionId,
  [in]  LPCSTR                     lpStringToFind,
  [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 redirección en el miembro hActCtx de la estructura de ACTCTX_SECTION_KEYED_DATA. El autor de la llamada debe usar releaseActCtx para liberar este contexto de activación.

[in] lpExtensionGuid

Reservado; debe ser NULL.

[in] ulSectionId

Identificador de la sección de cadena del contexto de activación en el que se va a buscar la cadena específica.

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

  • ACTIVATION_CONTEXT_SECTION_ASSEMBLY_INFORMATION
  • ACTIVATION_CONTEXT_SECTION_DLL_REDIRECTION
  • ACTIVATION_CONTEXT_SECTION_WINDOW_CLASS_REDIRECTION
  • ACTIVATION_CONTEXT_SECTION_COM_PROGID_REDIRECTION

[in] lpStringToFind

Puntero a una cadena terminada en null que se usará como criterio de búsqueda.

[out] ReturnedData

Puntero a una estructura de ACTCTX_SECTION_KEYED_DATA que se va a rellenar con la información de cadena 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, vea Recuperar el código de Last-Error. Para obtener una lista completa de los códigos de error, consulte Códigos de error del sistema.

Observaciones

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.

Nota

El encabezado winbase.h define FindActCtxSectionString como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito Valor
cliente mínimo admitido Windows XP [solo aplicaciones de escritorio]
servidor mínimo admitido Windows Server 2003 [solo aplicaciones de escritorio]
de la plataforma de destino de Windows
encabezado de winbase.h (incluya Windows.h)
biblioteca de Kernel32.lib
DLL de Kernel32.dll

Consulte también

ACTCTX_SECTION_KEYED_DATA

findActCtxSectionGuid