Função MsiRecordReadStream (msiquery.h)

A função MsiRecordReadStream lê bytes de um campo de fluxo de registro em um buffer.

Sintaxe

UINT MsiRecordReadStream(
  [in]      MSIHANDLE hRecord,
  [in]      UINT      iField,
  [out]     char      *szDataBuf,
  [in, out] LPDWORD   pcbDataBuf
);

Parâmetros

[in] hRecord

Manipule para o registro.

[in] iField

Especifica o campo do registro.

[out] szDataBuf

Um buffer para receber o campo de fluxo. Você deve garantir que o buffer de destino tenha o mesmo tamanho ou maior que o buffer de origem. Consulte a seção Comentários.

[in, out] pcbDataBuf

Especifica a contagem de buffers de entrada e saída. Na entrada, esse é o tamanho total do buffer. Na saída, esse é o número de bytes que foram realmente gravados no buffer. Consulte a seção Comentários.

Valor retornado

Essa função retorna UINT.

Comentários

Para ler um fluxo, defina pcbDataBuf como o número de bytes que devem ser transferidos do fluxo para o buffer sempre que a função for chamada. No retorno, o MsiRecordReadStream redefine pcbDataBuf para o número de bytes que foram realmente transferidos. Se o buffer for menor que o fluxo, o fluxo será reposicionado quando o buffer ficar cheio de modo que os próximos dados no fluxo sejam transferidos pela próxima chamada para a função. Quando não há mais bytes disponíveis, MsiRecordReadStream retorna ERROR_SUCCESS.

Se você passar 0 para szDataBuf , pcbDataBuf será redefinido para o número de bytes no fluxo restante a ser lido.

O exemplo de código a seguir lê de um fluxo que está no campo 1 de um registro especificado por hRecord e lê o fluxo inteiro de 8 bytes por vez.

char szBuffer[8];
PMSIHANDLE hRecord;
DWORD cbBuf = sizeof(szBuffer);
do 
{
    if (MsiRecordReadStream(hRecord, 1, szBuffer, 
        &cbBuf) != ERROR_SUCCESS)
        break; /* error */
}
while (cbBuf == 8);  //continue reading the stream while you receive a full buffer
//cbBuf will be less once you reach the end of the stream and cannot fill your 
//buffer with stream data

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

Requisitos

Confira também

Funções de processamento de registro