Compartilhar via


Método IStreamConcatenate::Initialize2 (imapi2.h)

Inicializa esse fluxo de uma matriz de fluxos de entrada.

Sintaxe

HRESULT Initialize2(
  [in] IStream **streams,
  [in] ULONG   streamCount
);

Parâmetros

[in] streams

Matriz de interfaces IStream dos fluxos a serem adicionados a esse fluxo.

[in] streamCount

Número de fluxos em fluxos.

Retornar valor

S_OK é retornado com êxito, mas outros códigos de êxito podem ser retornados como resultado da implementação. Os seguintes códigos de erro geralmente são retornados em caso de falha na operação, mas não representam os únicos valores de erro possíveis:

Código de retorno Descrição
E_POINTER
O ponteiro não é válido.

Valor: 0x80004003

E_OUTOFMEMORY
Falha ao alocar a memória necessária.

Valor: 0x8007000E

E_INVALIDARG
Esse fluxo já foi inicializado.

Valor: 0x80070057

Comentários

Ao usar a interface IStreamConcatenate , os seguintes cenários resultarão em comportamentos indefinidos e devem ser evitados:

  • Cada fluxo parcial que compõe o objeto MsftStreamConcatenate é, na verdade, o mesmo fluxo.
  • Qualquer um dos fluxos concatenados é modificado (lido de, gravado ou buscado) fora do IMAPI.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista, Windows XP com SP2 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho imapi2.h

Confira também

IStreamConcatenate

IStreamConcatenate::Initialize