Função MsiRecordSetStringA (msiquery.h)

Artigo
11/20/2024

A função MsiRecordSetString copia uma cadeia de caracteres para o campo designado.

Sintaxe

UINT MsiRecordSetStringA(
  [in] MSIHANDLE hRecord,
  [in] UINT      iField,
  [in] LPCSTR    szValue
);

Parâmetros

[in] hRecord

Manipule para o registro.

[in] iField

Especifica o campo do registro a ser definido.

[in] szValue

Especifica o valor da cadeia de caracteres do campo.

Valor de retorno

Essa função retorna UINT.

Observações

Na função MsiRecordSetString, um ponteiro de cadeia de caracteres nulo e uma cadeia de caracteres vazia definem o campo como nulo. A tentativa de armazenar um valor em um campo inexistente causa um erro.

Para definir um campo de cadeia de caracteres de registro como nulo, defina szValue como uma cadeia de caracteres nula ou uma cadeia de caracteres vazia.

Nota

O cabeçalho msiquery.h define MsiRecordSetString como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de 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 Installer 5.0 no Windows Server 2012, Windows 8, Windows Server 2008 R2 ou Windows 7. Windows Installer 4.0 ou Windows Installer 4.5 no Windows Server 2008 ou Windows Vista. Windows Installer no Windows Server 2003 ou Windows XP
da Plataforma de Destino	Windows
cabeçalho	msiquery.h
biblioteca	Msi.lib
de DLL	Msi.dll

Consulte também

Funções de processamento de registro

Compartilhar via