Funzione SHCreateStreamOnFileEx (shlwapi.h)

Articolo
08/26/2023

Apre o crea un file e recupera un flusso per leggere o scrivere in tale file.

Sintassi

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

Parametri

[in] pszFile

Tipo: LPCWSTR

Puntatore a una stringa con terminazione Null che specifica il nome del file.

[in] grfMode

Tipo: DWORD

Uno o più valori STGM utilizzati per specificare la modalità di accesso ai file e la modalità di creazione ed eliminazione dell'oggetto che espone il flusso.

[in] dwAttributes

Tipo: DWORD

Uno o più valori di flag che specificano gli attributi di file nel caso in cui venga creato un nuovo file. Per un elenco completo dei valori possibili, vedere il parametro dwFlagsAndAttributes della funzione CreateFile .

[in] fCreate

Tipo: BOOL

Valore BOOL che consente di specificare, insieme a grfMode, il modo in cui i file esistenti devono essere trattati durante la creazione del flusso. Per ulteriori informazioni, vedere Note.

[in, optional] pstmTemplate

Tipo: IStream*

Riservato.

[out] ppstm

Tipo: IStream**

Riceve un puntatore all'interfaccia IStream per il flusso associato al file.

Valore restituito

Tipo: HRESULT

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

La funzione SHCreateStreamOnFileEx estende la semantica dei flag STGM e produce lo stesso effetto della chiamata alla funzione CreateFile .

I parametri grfMode e fCreate interagiscono per specificare il comportamento della funzione rispetto ai file esistenti.

grfMode	fCreate	File esistente?	Comportamento
STGM_CREATE	Ignorato	Sì	Il file viene ricreato.
STGM_CREATE	Ignorato	No	Il file viene creato
STGM_FAILIFTHERE	FALSE	Sì	Il file viene aperto.
STGM_FAILIFTHERE	FALSE	No	La chiamata ha esito negativo.
STGM_FAILIFTHERE	TRUE	Sì	La chiamata ha esito negativo.
STGM_FAILIFTHERE	TRUE	No	Il file viene creato

Requisiti


Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shlwapi.h
Libreria	Shlwapi.lib
DLL	Shlwapi.dll (versione 6.0 o successiva)

Condividi tramite