Estrutura ACTCTXA (winbase.h)
A estrutura de
Sintaxe
typedef struct tagACTCTXA {
ULONG cbSize;
DWORD dwFlags;
LPCSTR lpSource;
USHORT wProcessorArchitecture;
LANGID wLangId;
LPCSTR lpAssemblyDirectory;
LPCSTR lpResourceName;
LPCSTR lpApplicationName;
HMODULE hModule;
} ACTCTXA, *PACTCTXA;
Membros
cbSize
O tamanho, em bytes, dessa estrutura. Isso é usado para determinar a versão dessa estrutura.
dwFlags
Sinalizadores que indicam como os valores incluídos nessa estrutura devem ser usados. Defina os bits indefinidos em dwFlags como 0. Se os bits indefinidos não forem definidos como 0, a chamada para CreateActCtx que cria o contexto de ativação falhará e retornará um código de erro de parâmetro inválido.
lpSource
Cadeia de caracteres terminada em nulo especificando o caminho do arquivo de manifesto ou da imagem PE a ser usado para criar o contexto de ativação. Se esse caminho se referir a um arquivo EXE ou DLL, o lpResourceName membro será necessário.
wProcessorArchitecture
Identifica o tipo de processador usado. Especifica a arquitetura do processador do sistema.
Esse valor pode ser um dos seguintes valores:
wLangId
Especifica o manifesto de idioma que deve ser usado. O padrão é o idioma atual da interface do usuário do usuário atual.
Se o idioma solicitado não puder ser encontrado, uma aproximação será pesquisada usando a seguinte ordem:
- O idioma específico do usuário atual. Por exemplo, para inglês dos EUA (1033).
- O idioma principal do usuário atual. Por exemplo, para inglês (9).
- O idioma específico do sistema atual.
- O idioma principal do sistema atual.
- Uma linguagem mundial não específica. Idioma neutro (0).
lpAssemblyDirectory
O diretório base no qual executar a investigação de assembly privado se os assemblies no contexto de ativação não estiverem presentes no repositório em todo o sistema.
lpResourceName
Ponteiro para uma cadeia de caracteres terminada em nulo que contém o nome do recurso a ser carregado do PE especificado em hModule ou lpSource. Se o nome do recurso for um inteiro, defina esse membro usando MAKEINTRESOURCE. Esse membro será necessário se lpSource se referir a um EXE ou DLL.
lpApplicationName
O nome do aplicativo atual. Se o valor desse membro for definido como nulo, o nome do executável que iniciou o processo atual será usado.
hModule
Use esse membro em vez de lpSource se você já tiver carregado uma DLL e desejar usá-la para criar contextos de ativação em vez de usar um caminho em lpSource. Consulte lpResourceName para obter as regras de pesquisa de recursos neste módulo.
Observações
Se o arquivo identificado pelo valor do membro lpSource for um arquivo de imagem PE, CreateActCtx procurará o manifesto no arquivo .manifest localizado no mesmo diretório e no primeiro recurso RT_MANIFEST localizado no arquivo de imagem PE. Para localizar um recurso nomeado específico da imagem, defina o lpResourceName ao nome do recurso e adicione o ACTCTX_FLAG_RESOURCE_NAME_VALID ao membro dwFlags. Consulte FindResource para obter mais informações sobre como especificar nomes de recursos.
Na maioria dos casos, o chamador não deve definir os sinalizadores ACTCTX_FLAG_PROCESSOR_ARCHITECTURE_VALID e ACTCTX_FLAG_LANGID_VALID do membro dwFlags
Os valores de lpApplicationName e lpAssemblyDirectory não são definidos como nulos quando o executável que cria o contexto de ativação é um host para o aplicativo. Nesse caso, o host pode definir um nome diferente para o aplicativo localizar arquivos de configuração, erros de relatório e assim por diante.
Nota
O cabeçalho winbase.h define ACTCTX como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows XP [somente aplicativos da área de trabalho] |
| servidor com suporte mínimo | Windows Server 2003 [somente aplicativos da área de trabalho] |
| cabeçalho | winbase.h (inclua Windows.h) |