Partilhar via

COleStreamFile Classe

  • Artigo

Representa um fluxo de dados (IStream) em um arquivo composto como parte do armazenamento estruturado OLE.

Sintaxe

class COleStreamFile : public CFile

Membros

Construtores Públicos

Designação Descrição
COleStreamFile::COleStreamFile Constrói um objeto COleStreamFile.

Métodos Públicos

Designação Descrição
COleStreamFile::Anexar Associa um fluxo ao objeto.
COleStreamFile::CreateMemoryStream Cria um fluxo da memória global e o associa ao objeto.
COleStreamFile::CreateStream Cria um fluxo e o associa ao objeto.
COleStreamFile::D etach Desassocia o fluxo do objeto.
COleStreamFile::GetStream Retorna o fluxo atual.
COleStreamFile::OpenStream Abre um fluxo com segurança e associa-o ao objeto.

Comentários

Um objeto IStorage deve existir antes que o fluxo possa ser aberto ou criado, a menos que seja um fluxo de memória.

COleStreamFile objetos são manipulados exatamente como objetos CFile.

Para obter mais informações sobre como manipular fluxos e armazenamentos, consulte o artigo Containers: Compound Files.

Para obter mais informações, consulte IStream e IStorage no SDK do Windows.

Hierarquia de herança

CObject

CFile

COleStreamFile

Requerimentos

Cabeçalho: afxole.h

COleStreamFile::Anexar

Associa o fluxo OLE fornecido ao objeto COleStreamFile.

void Attach(LPSTREAM lpStream);

Parâmetros

lpStream
Aponta para o fluxo OLE (IStream) a ser associado ao objeto. Não pode ser NULL.

Comentários

O objeto ainda não deve estar associado a um fluxo OLE.

Para obter mais informações, consulte IStream no SDK do Windows.

COleStreamFile::COleStreamFile

Cria um objeto COleStreamFile.

COleStreamFile(LPSTREAM lpStream = NULL);

Parâmetros

lpStream
Ponteiro para o fluxo OLE a ser associado ao objeto.

Comentários

Se lpStream for NULL, o objeto não está associado a um fluxo OLE, caso contrário, o objeto está associado ao fluxo OLE fornecido.

Para obter mais informações, consulte IStream no SDK do Windows.

COleStreamFile::CreateMemoryStream

Cria com segurança um novo fluxo de memória global compartilhada onde uma falha é uma condição normal e esperada.

BOOL CreateMemoryStream(CFileException* pError = NULL);

Parâmetros

pError
Aponta para um objeto CFileException ou NULL que indica o status de conclusão da operação create. Forneça esse parâmetro se quiser monitorar possíveis exceções geradas ao tentar criar o fluxo.

Valor de retorno

Diferente de zero se o fluxo for criado com êxito; caso contrário, 0.

Comentários

A memória é alocada pelo subsistema OLE.

Para obter mais informações, consulte CreateStreamOnHGlobal no SDK do Windows.

COleStreamFile::CreateStream

Cria com segurança um novo fluxo no objeto de armazenamento fornecido onde uma falha é uma condição normal e esperada.

BOOL CreateStream(
    LPSTORAGE lpStorage,
    LPCTSTR lpszStreamName,
    DWORD nOpenFlags = modeReadWrite|shareExclusive|modeCreate,
    CFileException* pError = NULL);

Parâmetros

lpStorage
Aponta para o objeto de armazenamento OLE que contém o fluxo a ser criado. Não pode ser NULL.

lpszStreamName
Nome do fluxo a ser criado. Não pode ser NULL.

nOpenFlags
Modo de acesso para usar ao abrir o fluxo. Os modos exclusivo, de leitura/gravação e de criação são usados por padrão. Para obter uma lista completa dos modos disponíveis, consulte CFile::CFile.

pError
Aponta para um objeto CFileException ou NULL. Forneça esse parâmetro se quiser monitorar possíveis exceções geradas ao tentar criar o fluxo.

Valor de retorno

Diferente de zero se o fluxo for criado com êxito; caso contrário, 0.

Comentários

Uma exceção de arquivo será lançada se a abertura falhar e pError não for NULL.

Para obter mais informações, consulte IStorage::CreateStream no SDK do Windows.

COleStreamFile::D etach

Desassocia o fluxo do objeto sem fechá-lo.

LPSTREAM Detach();

Valor de retorno

Um ponteiro para o fluxo (IStream) que foi associado ao objeto.

Comentários

O fluxo deve ser fechado de alguma outra forma antes que o programa termine.

Para obter mais informações, consulte IStream no SDK do Windows.

COleStreamFile::GetStream

Chame essa função para retornar um ponteiro ao fluxo atual.

IStream* GetStream() const;

Valor de retorno

Um ponteiro para a interface de fluxo atual ( IStream).

COleStreamFile::OpenStream

Abre um fluxo existente.

BOOL OpenStream(
    LPSTORAGE lpStorage,
    LPCTSTR lpszStreamName,
    DWORD nOpenFlags = modeReadWrite|shareExclusive,
    CFileException* pError = NULL);

Parâmetros

lpStorage
Aponta para o objeto de armazenamento OLE que contém o fluxo a ser aberto. Não pode ser NULL.

lpszStreamName
Nome do fluxo a ser aberto. Não pode ser NULL.

nOpenFlags
Modo de acesso para usar ao abrir o fluxo. Os modos exclusivo e de leitura/gravação são usados por padrão. Para obter a lista completa dos modos disponíveis, consulte CFile::CFile.

pError
Aponta para um objeto CFileException ou NULL. Forneça esse parâmetro se quiser monitorar possíveis exceções geradas ao tentar abrir o fluxo.

Valor de retorno

Diferente de zero se o fluxo for aberto com êxito; caso contrário, 0.

Comentários

Uma exceção de arquivo será lançada se a abertura falhar e pError não for NULL.

Para obter mais informações, consulte IStorage::OpenStream no SDK do Windows.

Ver também

CFile Classe
Gráfico de Hierarquia