Função SHCreateStreamOnFileW (shlwapi.h)

Artigo
11/20/2024

[SHCreateStreamOnFile está disponível para uso nos sistemas operacionais especificados na seção Requisitos. Ele pode estar alterado ou indisponível em versões subsequentes. Em vez disso, use SHCreateStreamOnFileEx.]

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

Sintaxe

LWSTDAPI SHCreateStreamOnFileW(
  [in]  LPCWSTR pszFile,
  [in]  DWORD   grfMode,
  [out] IStream **ppstm
);

Parâmetros

[in] pszFile

Tipo: LPCTSTR

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

[in] grfMode

Tipo: DWORD

Uma 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.

[out] ppstm

Tipo: ** IStream

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

Valor de retorno

Tipo: HRESULT

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

Observações

SHCreateStreamOnFileEx dá suporte total a todos os modos de STGM e permite que o chamador especifique atributos de arquivo se criar um novo arquivo.

Nota

O cabeçalho shlwapi.h define SHCreateStreamOnFile como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows XP [somente aplicativos da área de trabalho]
servidor com suporte mínimo	Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	shlwapi.h
biblioteca	Shlwapi.lib
de DLL	Shlwapi.dll (versão 5.0 ou posterior)

Compartilhar via