Função MsiViewGetErrorW (msiquery.h)

A função MsiViewGetError retorna o erro que ocorreu na função MsiViewModify .

Sintaxe

MSIDBERROR MsiViewGetErrorW(
  [in]      MSIHANDLE hView,
  [out]     LPWSTR    szColumnNameBuffer,
  [in, out] LPDWORD   pcchBuf
);

Parâmetros

[in] hView

Manipule para o modo de exibição.

[out] szColumnNameBuffer

Ponteiro para o buffer que recebe o nome da coluna terminada em nulo. Não tente determinar o tamanho do buffer passando um nulo (value=0) para szColumnName. Você pode obter o tamanho do buffer passando uma cadeia de caracteres vazia (por exemplo, ""). Em seguida, a função retorna MSIDBERROR_MOREDATA e pcchBuf contém o tamanho do buffer necessário em TCHARs, sem incluir o caractere nulo de terminação. No retorno de MSIDBERROR_NOERROR, pcchBuf contém o número de TCHARs gravados no buffer, sem incluir o caractere nulo de terminação. Esse parâmetro será uma cadeia de caracteres vazia se não houver erros.

[in, out] pcchBuf

Ponteiro para a variável que especifica o tamanho, em TCHARs, do buffer apontado pela variável szColumnNameBuffer. Quando a função retorna MSIDBERROR_NOERROR, essa variável contém o tamanho dos dados copiados para szColumnNameBuffer, sem incluir o caractere nulo de terminação. Se szColumnNameBuffer não for grande o suficiente, a função retornará MSIDBERROR_MOREDATA e armazenará o tamanho necessário, sem incluir o caractere nulo de terminação, na variável apontada por pcchBuf.

Retornar valor

Essa função retorna um dos valores a seguir.

Observe que, em situações de memória baixa, essa função pode gerar uma exceção STATUS_NO_MEMORY.

Comentários

Você só deve chamar a função MsiViewGetError quando MsiViewModify retornar ERROR_INVALID_DATA, indicando que os dados são inválidos. Os erros são registrados apenas para MSIMODIFY_VALIDATE, MSIMODIFY_VALIDATE_NEW e MSIMODIFY_VALIDATEFIELD.

Se ERROR_MORE_DATA for retornado, o parâmetro que é um ponteiro fornecerá o tamanho do buffer necessário para manter a cadeia de caracteres. Após o sucesso, ele fornece o número de caracteres gravados no buffer de cadeia de caracteres. Portanto, você pode obter o tamanho necessário do buffer passando um buffer pequeno (mínimo de um caractere) e examinando o valor em pcchPathBuf quando a função retorna MSIDBERROR_MOREDATA. Não tente determinar o tamanho do buffer passando nulo como szColumnNameBuffer ou um tamanho de buffer de 0 no DWORD referenciado por pcchBuf.

Depois que MSIDBERROR_NOERROR é retornado, não há mais erros de validação. O valor retornado MSIDBERROR indica o tipo de erro de validação que ocorreu para o valor localizado na coluna identificada pelo szColumnNameBuffer.

Requisitos

Confira também

Funções gerais de acesso ao banco de dados

Passando Null como o argumento das funções do Windows Installer