Função MsiRecordGetStringA (msiquery.h)

A função MsiRecordGetString retorna o valor da cadeia de caracteres de um campo de registro.

Sintaxe

UINT MsiRecordGetStringA(
  [in]      MSIHANDLE hRecord,
  [in]      UINT      iField,
  [out]     LPSTR     szValueBuf,
  [in, out] LPDWORD   pcchValueBuf
);

Parâmetros

[in] hRecord

Manipule para o registro.

[in] iField

Especifica o campo solicitado.

[out] szValueBuf

Ponteiro para o buffer que recebe a cadeia de caracteres terminada em nulo que contém o valor do campo de registro. Não tente determinar o tamanho do buffer passando um nulo (value=0) para szValueBuf. Você pode obter o tamanho do buffer passando uma cadeia de caracteres vazia (por exemplo, ""). Em seguida, a função retorna ERROR_MORE_DATA e pcchValueBuf contém o tamanho do buffer necessário em TCHARs, sem incluir o caractere nulo de terminação. No retorno de ERROR_SUCCESS, pcchValueBuf contém o número de TCHARs gravados no buffer, sem incluir o caractere nulo de terminação.

[in, out] pcchValueBuf

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

Retornar valor

A função MsiRecordGetString retorna um dos seguintes valores:

Comentários

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. Se ERROR_SUCCESS for retornado, ele fornecerá o número de caracteres gravados no buffer de cadeia de caracteres. Para obter o tamanho do buffer, passe o endereço de um buffer de 1 caractere como szValueBuf e especifique o tamanho do buffer com pcchValueBuf como 0. Isso garante que nenhum valor de cadeia de caracteres retornado pela função se ajuste ao buffer. Não tente determinar o tamanho do buffer passando um Null (value=0).

Requisitos

Confira também

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

Funções de processamento de registro