Método IMsmError::get_Type (mergemod.h)
O método get_Type recupera a propriedade Type do objeto Error . Esse método retorna um valor msmErrorType que indica o tipo de erro representado por esse objeto.
Sintaxe
HRESULT get_Type(
[out] msmErrorType *ErrorType
);
Parâmetros
[out] ErrorType
Um ponteiro para um local na memória que recebe o tipo de erro.
| msmErrorType | Valor | Descrição |
|---|---|---|
| msmErrorLanguageUnsupported | 1 | Foi feita uma solicitação para abrir um módulo com um idioma sem suporte do módulo. Não há mais suporte para o idioma geral no módulo. Adiciona msmErrorLanguageUnsupported à propriedade Type e ao idioma solicitado à propriedade Language (Objeto Error). Todas as propriedades do objeto Error estão vazias. A função OpenModule retorna ERROR_INSTALL_LANGUAGE_UNSUPPORTED (como HRESULT). |
| msmErrorLanguageFailed | 2 | Foi feita uma solicitação para abrir um módulo com um idioma com suporte, mas o módulo tem uma transformação de idioma inválida. Adiciona msmErrorLanguageFailed à propriedade Type e o idioma da transformação aplicada à Propriedade Language do objeto Error . Esse pode não ser o idioma solicitado se um idioma mais geral foi usado. Todas as outras propriedades do objeto Error estão vazias. A função OpenModule retorna ERROR_INSTALL_LANGUAGE_UNSUPPORTED (como HRESULT). |
| msmErrorExclusion | 3 | O módulo não pode ser mesclado porque exclui ou é excluído por outro módulo no banco de dados. Adiciona msmErrorExclusion à propriedade Type do objeto Error . A propriedade ModuleKeys ou a propriedade DatabaseKeys contém as chaves primárias da linha do módulo excluído na tabela ModuleExclusion. Se um módulo existente excluir o módulo que está sendo mesclado, as informações moduleSignature do módulo excluído serão adicionadas a ModuleKeys. Se o módulo que está sendo mesclado excluir um módulo existente, DatabaseKeys conterá as informações moduleSignature do módulo excluído. Todas as outras propriedades estão vazias (ou -1). |
| msmErrorTableMerge | 4 | Conflito de mesclagem durante a mesclagem. O valor da propriedade Type é definido como msmErrorTableMerge. A propriedade DatabaseTable e a propriedade DatabaseKeys contêm o nome da tabela e as chaves primárias da linha conflitante no banco de dados. A propriedade ModuleTable e a propriedade ModuleKeys contêm o nome da tabela e as chaves primárias da linha conflitante no módulo. As entradas ModuleTable e ModuleKeys poderão ser nulas se a linha não existir no banco de dados. Por exemplo, se o conflito estiver em uma entrada de tabela FeatureComponents gerada. Ao mesclar um módulo de mesclagem configurável, a configuração pode fazer com que essas propriedades façam referência a linhas que não existem no módulo. |
| msmErrorResequenceMerge | 5 | Houve um problema ao reequencar uma tabela de sequência para conter as ações mescladas necessárias. A propriedade Type é definida como msmErrorResequenceMerge. As propriedades DatabaseTable e DatabaseKeys contêm o nome da tabela de sequência e as chaves primárias (nome da ação) da linha conflitante. As propriedades ModuleTable e ModuleKeys contêm o nome da tabela de sequência e a chave primária (nome da ação) da linha conflitante. Ao mesclar um módulo de mesclagem configurável, a configuração pode fazer com que essas propriedades façam referência a linhas que não existem no módulo. |
| msmErrorFileCreate | 6 | Não usado. |
| msmErrorDirCreate | 7 | Houve um problema ao criar um diretório para extrair um arquivo para o disco. A propriedade Path contém o diretório que não pôde ser criado. Todas as outras propriedades estão vazias ou -1. |
| msmErrorFeatureRequired | 8 | Um nome de recurso é necessário para concluir a mesclagem, mas nenhum nome de recurso foi fornecido. A propriedade Type é definida como msmErrorFeatureRequired. DatabaseTable e DatabaseKeys contêm o nome da tabela e as chaves primárias da linha conflitante. As propriedades ModuleTable e ModuleKeys contêm o nome da tabela e as chaves primárias da linha não podem ser mescladas. Ao mesclar um módulo de mesclagem configurável, a configuração pode fazer com que essas propriedades façam referência a linhas que não existem no módulo. Se a falha estiver em uma tabela FeatureComponents gerada, as propriedades DatabaseTable e DatabaseKeys estarão vazias e as propriedades ModuleTable e ModuleKeys se referirão à linha na tabela Component que está causando a falha. |
| msmErrorBadNullSubstitution | 9 | Substituição de um valor Null em uma coluna não anulável. Isso insere msmErrorBadNullSubstitution na propriedade Type e insere "ModuleSubstitution" e as chaves da tabela ModuleSubstitution dessa linha na propriedade ModuleTable e na propriedade ModuleKeys . Todas as outras propriedades do objeto Error são definidas como uma cadeia de caracteres vazia ou -1.
Esse erro faz com que a falha imediata da mesclagem e da funçãoMergeEx retorne E_FAIL. |
| msmErrorBadSubstitutionType | 10 | Substituição de Tipo de Formato de Texto ou Tipo de Formato Inteiro em uma coluna de dados tipo binário . Esse tipo de erro retorna msmErrorBadSubstitutionType na propriedade Type e insere "ModuleSubstitution" e as chaves da tabela ModuleSubstitution dessa linha na propriedade ModuleTable . Todas as outras propriedades do objeto Error são definidas como uma cadeia de caracteres vazia ou -1.
Esse erro faz com que a falha imediata da mesclagem e da funçãoMergeEx retorne E_FAIL. |
| msmErrorMissingConfigItem | 11 | Uma linha na tabela ModuleSubstitution faz referência a um item de configuração não definido na tabela ModuleConfiguration. Esse tipo de erro retorna msmErrorMissingConfigItem na propriedade Type e insere "ModuleSubstitution" e as chaves da tabela ModuleSubstitution dessa linha na propriedade ModuleTable . Todas as outras propriedades do objeto Error são definidas como uma cadeia de caracteres vazia ou -1.
Esse erro faz com que a falha imediata da mesclagem e da funçãoMergeEx retorne E_FAIL. |
| msmErrorBadNullResponse | 12 | A ferramenta de criação retornou um valor Null para um item marcado com o atributo msmConfigItemNonNullable. Um erro desse tipo retorna msmErrorBadNullResponse na propriedade Type e insere "ModuleSubstitution" e as chaves da tabela ModuleSubstitution para o item na propriedade ModuleTable . Todas as outras propriedades do objeto Error são definidas como uma cadeia de caracteres vazia ou -1.
Esse erro faz com que a falha imediata da mesclagem e da funçãoMergeEx retorne E_FAIL. |
| msmErrorDataRequestFailed | 13 | A ferramenta de criação retornou um código de falha (não S_OK ou S_FALSE) quando solicitado a fornecer dados. Um erro desse tipo retornará msmErrorDataRequestFailed na propriedade Type e inserirá "ModuleSubstitution" e as chaves da tabela ModuleSubstitution do item na propriedade ModuleTable . Todas as outras propriedades do objeto Error são definidas como uma cadeia de caracteres vazia ou -1.
Esse erro faz com que a falha imediata da mesclagem e da funçãoMergeEx retorne E_FAIL. |
| msmErrorPlatformMismatch | 14 | Indica que foi feita uma tentativa de mesclar um módulo de 64 bits em um pacote que não era um pacote de 64 bits. Um erro desse tipo retorna msmErrorPlatformMismatch na propriedade Type . Todas as outras propriedades do objeto de erro são definidas como uma cadeia de caracteres vazia ou -1. Esse erro causa a falha imediata da mesclagem e faz com que a função Merge ou MergeEx retorne E_FAIL. |
Retornar valor
Esse método pode retornar um desses valores.
| Valor | Significado |
|---|---|
|
ErrorType é Null. |
|
A função foi bem-sucedida. |
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Mergemod.dll 2.0 ou versões posteriores |
| Plataforma de Destino | Windows |
| Cabeçalho | mergemod.h |
| DLL | Mergemod.dll |