Função MsiRecordSetStreamA (msiquery.h)

Artigo
11/20/2024

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.

Valor de retorno

A função MsiRecordSetStream de retorna os seguintes valores:

Observações

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 Nulo 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 streams.

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

Nota

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 do 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