Função SHCreateStreamOnFileEx (shlwapi.h)

Abre ou cria um arquivo e recupera um fluxo para ler ou gravar nesse arquivo.

Sintaxe

LWSTDAPI SHCreateStreamOnFileEx(
  [in]           LPCWSTR pszFile,
  [in]           DWORD   grfMode,
  [in]           DWORD   dwAttributes,
  [in]           BOOL    fCreate,
  [in, optional] IStream *pstmTemplate,
  [out]          IStream **ppstm
);

Parâmetros

[in] pszFile

Tipo: LPCWSTR

Um ponteiro para uma cadeia de caracteres terminada em nulo que especifica o nome do arquivo.

[in] grfMode

Tipo: DWORD

Um ou mais valores STGM que são usados para especificar o modo de acesso ao arquivo e como o objeto que expõe o fluxo é criado e excluído.

[in] dwAttributes

Tipo: DWORD

Um ou mais valores de sinalizador que especificam atributos de arquivo no caso de um novo arquivo ser criado. Para obter uma lista completa dos valores possíveis, consulte o parâmetro dwFlagsAndAttributes da função CreateFile .

[in] fCreate

Tipo: BOOL

Um valor BOOL que ajuda a especificar, em conjunto com grfMode, como os arquivos existentes devem ser tratados ao criar o fluxo. Consulte Comentários para obter detalhes.

[in, optional] pstmTemplate

Tipo: IStream*

Reservado.

[out] ppstm

Tipo: IStream**

Recebe um ponteiro de interface IStream para o fluxo associado ao arquivo.

Valor retornado

Tipo: HRESULT

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

A função SHCreateStreamOnFileEx estende a semântica dos sinalizadores STGM e produz o mesmo efeito que chamar a função CreateFile .

Os parâmetros grfMode e fCreate funcionam juntos para especificar como a função deve se comportar em relação aos arquivos existentes.

Grfmode	fCreate	O arquivo existe?	Comportamento
STGM_CREATE	Ignored	Sim	O arquivo é recriado.
STGM_CREATE	Ignored	Não	O arquivo é criado.
STGM_FAILIFTHERE	FALSE	Sim	O arquivo é aberto.
STGM_FAILIFTHERE	FALSE	Não	A chamada falha.
STGM_FAILIFTHERE	TRUE	Sim	A chamada falha.
STGM_FAILIFTHERE	TRUE	Não	O arquivo é criado.

Requisitos

Cliente mínimo com suporte	Windows XP [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	shlwapi.h
Biblioteca	Shlwapi.lib
DLL	Shlwapi.dll (versão 6.0 ou posterior)