Método IOpcFactory::CreateStreamOnFile (msopc.h)

Artigo
11/20/2024

Cria um fluxo em um arquivo. Esse método é um wrapper simplificado para uma chamada para a função CreateFile. CreateFile parâmetros que não são expostos por meio desse método usam seus valores padrão. Para obter mais informações, consulte CreateFile.

Sintaxe

HRESULT CreateStreamOnFile(
  [in]          LPCWSTR               filename,
  [in]          OPC_STREAM_IO_MODE    ioMode,
  [in]          LPSECURITY_ATTRIBUTES securityAttributes,
  [in]          DWORD                 dwFlagsAndAttributes,
  [out, retval] IStream               **stream
);

Parâmetros

[in] filename

O nome do arquivo no qual o fluxo é criado.

[in] ioMode

O valor que descreve o status de leitura/gravação do fluxo a ser criado.

[in] securityAttributes

Para obter informações sobre a estrutura SECURITY_ATTRIBUTES nesse parâmetro, consulte a função CreateFile.

[in] dwFlagsAndAttributes

As configurações e os atributos do arquivo. Para a maioria dos arquivos, FILE_ATTRIBUTE_NORMAL pode ser usado.

Para obter mais informações sobre esse parâmetro, consulte CreateFile.

[out, retval] stream

Um ponteiro para a interface de IStream do do fluxo.

Valor de retorno

O método retorna umHRESULT . Os valores possíveis incluem, mas não se limitam a, aqueles na tabela a seguir.

Código de retorno	Descrição
S_OK	O método foi bem-sucedido.
E_INVALIDARG	O valor passado no parâmetro ioMode não é um valor de enumeração de OPC_STREAM_IO_MODE válido.
E_POINTER	Pelo menos um dos parâmetros de de fluxo de é NULL.
erro de função CreateFile	Um código de erro HRESULT da função CreateFile .

Observações

Não use um fluxo para serializar dados do pacote quando o mesmo fluxo estiver sendo usado para desserializar um pacote, pois a tentativa pode resultar em um comportamento indefinido.

Para obter informações sobre como usar esse método ao carregar ou salvar um pacote, consulte o Carregando um pacote ou salvando um pacote tarefa de programação.

suporte em versões anteriores do Windows

O comportamento e o desempenho desse método são os mesmos em todas as versões do Windows com suporte. Para obter mais informações, consulte Introdução aode API de Empacotamento e Platform Update para Windows Vista.

Segurança de thread

Os objetos de empacotamento não são thread-safe.

Para obter mais informações, consulte o Introdução à API de Empacotamento.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 7, Windows Vista com SP2 e Atualização de Plataforma para Windows Vista [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2008 R2, Windows Server 2008 com SP2 e Platform Update para Windows Server 2008 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	msopc.h