Estructura ACTCTXA (winbase.h)

La estructura ACTCTX la usa la función CreateActCtx para crear el contexto de activación.

Sintaxis

typedef struct tagACTCTXA {
  ULONG   cbSize;
  DWORD   dwFlags;
  LPCSTR  lpSource;
  USHORT  wProcessorArchitecture;
  LANGID  wLangId;
  LPCSTR  lpAssemblyDirectory;
  LPCSTR  lpResourceName;
  LPCSTR  lpApplicationName;
  HMODULE hModule;
} ACTCTXA, *PACTCTXA;

Miembros

cbSize

Tamaño, en bytes, de esta estructura. Se usa para determinar la versión de esta estructura.

dwFlags

Marcas que indican cómo se van a usar los valores incluidos en esta estructura. Establezca los bits no definidos en dwFlags en 0. Si los bits no definidos no están establecidos en 0, la llamada a CreateActCtx que crea el contexto de activación produce un error y devuelve un código de error de parámetro no válido.

lpSource

Cadena terminada en NULL que especifica la ruta de acceso del archivo de manifiesto o la imagen PE que se va a usar para crear el contexto de activación. Si esta ruta de acceso hace referencia a un archivo EXE o DLL, se requiere el lpResourceName miembro.

wProcessorArchitecture

Identifica el tipo de procesador usado. Especifica la arquitectura del procesador del sistema.

Este valor puede ser uno de los siguientes valores:

wLangId

Especifica el manifiesto de idioma que se debe usar. El valor predeterminado es el idioma actual de la interfaz de usuario del usuario actual.

Si no se encuentra el idioma solicitado, se busca una aproximación mediante el orden siguiente:

• Idioma específico del usuario actual. Por ejemplo, para inglés de EE. UU. (1033).
• Idioma principal del usuario actual. Por ejemplo, para inglés (9).
• Idioma específico del sistema actual.
• Idioma principal del sistema actual.
• Un idioma no específico en todo el mundo. Idioma neutro (0).

lpAssemblyDirectory

Directorio base en el que se va a realizar un sondeo de ensamblado privado si los ensamblados del contexto de activación no están presentes en el almacén de todo el sistema.

lpResourceName

Puntero a una cadena terminada en null que contiene el nombre del recurso que se va a cargar desde el PE especificado en hModule o lpSource. Si el nombre del recurso es un entero, establezca este miembro mediante MAKEINTRESOURCE. Este miembro es necesario si lpSource hace referencia a un ARCHIVO EXE o DLL.

lpApplicationName

Nombre de la aplicación actual. Si el valor de este miembro se establece en NULL, se usa el nombre del archivo ejecutable que inició el proceso actual.

hModule

Use este miembro en lugar de lpSource si ya ha cargado un archivo DLL y desea usarlo para crear contextos de activación en lugar de usar una ruta de acceso en lpSource. Consulte lpResourceName para conocer las reglas de búsqueda de recursos en este módulo.

Observaciones

Si el archivo identificado por el valor del lpSource miembro es un archivo de imagen PE, CreateActCtx busca el manifiesto en el archivo .manifest ubicado en el mismo directorio y en el primer recurso RT_MANIFEST ubicado en el archivo de imagen PE. Para buscar un recurso con nombre específico de la imagen, establezca el lpResourceName en el nombre del recurso y agregue el ACTCTX_FLAG_RESOURCE_NAME_VALID al miembro dwFlags. Consulte FindResource para obtener más información sobre cómo especificar nombres de recursos.

En la mayoría de los casos, el autor de la llamada no debe establecer las marcas ACTCTX_FLAG_PROCESSOR_ARCHITECTURE_VALID y ACTCTX_FLAG_LANGID_VALID del miembro dwFlags. Además, en la mayoría de los casos, el valor del miembro lpResourceName debe establecerse en null.

Los valores de lpApplicationName y lpAssemblyDirectory no se establecen en NULL cuando el ejecutable que crea el contexto de activación es un host para la aplicación. En este caso, el host puede establecer un nombre diferente para que la aplicación busque archivos de configuración, notificar errores, etc.

Requisitos

Consulte también

ACTCTX_SECTION_KEYED_DATA

CreateActCtx