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 de 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.

Value 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 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 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, 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.

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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.

Requisitos

   
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

FindActCtxSectionGuid