Compartilhar via


Função MsiRecordSetStreamA (msiquery.h)

A função MsiRecordSetStream define um campo de fluxo de registro de um arquivo. Os dados de fluxo não podem ser inseridos em campos temporários.

Sintaxe

UINT MsiRecordSetStreamA(
  [in] MSIHANDLE hRecord,
  [in] UINT      iField,
  [in] LPCSTR    szFilePath
);

Parâmetros

[in] hRecord

Manipule para o registro.

[in] iField

Especifica o campo do registro a ser definido.

[in] szFilePath

Especifica o caminho para o arquivo que contém o fluxo.

Retornar valor

A função MsiRecordSetStream retorna os seguintes valores:

Comentários

O conteúdo do arquivo especificado na função MsiRecordSetStream é lido em um objeto de fluxo. O fluxo persistirá se o registro for inserido no banco de dados e o banco de dados for confirmado.

Para redefinir o fluxo para o início, você deve passar um ponteiro Null para szFilePath. Não passe um ponteiro para uma cadeia de caracteres vazia, "", para redefinir o fluxo.

Consulte também Limitações de OLE em fluxos.

Se a função falhar, você poderá obter informações de erro estendidas usando MsiGetLastErrorRecord.

Observação

O cabeçalho msiquery.h define MsiRecordSetStream 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. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Installer 5.0 no Windows Server 2012, no Windows 8, no Windows Server 2008 R2 ou no Windows 7. Windows Installer 4.0 ou Windows Installer 4.5 no Windows Server 2008 ou no Windows Vista. Windows Installer no Windows Server 2003 ou no Windows XP
Plataforma de Destino Windows
Cabeçalho msiquery.h
Biblioteca Msi.lib
DLL Msi.dll

Confira também

Funções de processamento de registro