Compartilhar via


Método IStorage::CreateStream (objidl.h)

O método CreateStream cria e abre um objeto de fluxo com o nome especificado contido neste objeto de armazenamento. Todos os elementos dentro de objetos de armazenamento, fluxos e outros objetos de armazenamento, são mantidos no mesmo espaço de nome.

Sintaxe

HRESULT CreateStream(
  [in]  const OLECHAR *pwcsName,
  [in]  DWORD         grfMode,
  [in]  DWORD         reserved1,
  [in]  DWORD         reserved2,
  [out] IStream       **ppstm
);

Parâmetros

[in] pwcsName

Um ponteiro para uma cadeia de caracteres Unicode terminada em nulo largo que contém o nome do fluxo recém-criado. O nome pode ser usado posteriormente para abrir ou reabrir o fluxo. O nome não deve exceder 31 caracteres de comprimento, sem incluir o terminador de cadeia de caracteres. Os caracteres de 000 a 01f, que servem como o primeiro caractere do nome de fluxo/armazenamento, são reservados para uso pelo OLE. Essa é uma restrição de arquivo composta, não uma restrição de armazenamento estruturada.

[in] grfMode

Especifica o modo de acesso a ser usado ao abrir o fluxo recém-criado. Para obter mais informações e descrições dos valores possíveis, consulte Constantes STGM.

[in] reserved1

Reservado para uso futuro; deve ser zero.

[in] reserved2

Reservado para uso futuro; deve ser zero.

[out] ppstm

No retorno, ponteiro para o local do novo ponteiro da interface IStream . Isso só será válido se a operação for bem-sucedida. Quando ocorre um erro, esse parâmetro é definido como NULL.

Retornar valor

Esse método pode retornar um desses valores.

Código de retorno Descrição
S_OK O novo fluxo foi criado com êxito.
E_PENDING Somente armazenamento assíncrono: parte ou todos os dados necessários estão indisponíveis no momento.
STG_E_ACCESSDENIED Não há permissões suficientes para criar fluxo.
STG_E_FILEALREADYEXISTS O nome especificado para o fluxo já existe no objeto de armazenamento e o parâmetro grfMode inclui o valor STGM_FAILIFTHERE.
STG_E_INSUFFICIENTMEMORY O fluxo não foi criado devido à falta de memória.
STG_E_INVALIDFLAG O valor especificado para o parâmetro grfMode não é um valor válido de constantes STGM .
STG_E_INVALIDFUNCTION Não há suporte para a combinação especificada de sinalizadores no parâmetro grfMode ; por exemplo, quando esse método é chamado sem o sinalizador STGM_SHARE_EXCLUSIVE.
STG_E_INVALIDNAME Valor inválido para pwcsName.
STG_E_INVALIDPOINTER O ponteiro especificado para o objeto de fluxo era inválido.
STG_E_INVALIDPARAMETER Um dos parâmetros era inválido.
STG_E_REVERTED O objeto de armazenamento foi invalidado por uma operação de reverter acima dele na árvore de transações.
STG_E_TOOMANYOPENFILES O fluxo não foi criado porque há muitos arquivos abertos.

Comentários

Se um fluxo com o nome especificado no parâmetro pwcsName já existir e o parâmetro grfMode incluir o sinalizador STGM_CREATE, o fluxo existente será substituído por um recém-criado. Tanto a destruição do fluxo antigo quanto a criação do novo objeto de fluxo estão sujeitos ao modo de transação no objeto de armazenamento pai.

A implementação do arquivo composto fornecido por COM do método IStorage::CreateStream não dá suporte aos seguintes comportamentos:

  • Não há suporte para o sinalizador STGM_DELETEONRELEASE.
  • Não há suporte para o modo transacionado (STGM_TRANSACTED) para objetos de fluxo.
  • Não há suporte para abrir o mesmo fluxo mais de uma vez do mesmo armazenamento. O sinalizador STGM_SHARE_EXCLUSIVE modo de compartilhamento deve ser especificado no parâmetro grfMode .
Se o fluxo já existir e grfMode estiver definido como STGM_FAILIFTHERE, esse método falhará com o valor retornado STG_E_FILEALREADYEXISTS.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows 2000 Server [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho objidl.h
Biblioteca Uuid.lib
DLL Ole32.dll

Confira também

IStorage – Implementação de arquivo composto

IStorage::OpenStream

Istream