Funzione SHCreateStreamOnFileA (shlwapi.h)

Articolo
11/20/2024

[SHCreateStreamOnFile è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. Potrebbe essere modificato o non disponibile nelle versioni successive. Usare invece SHCreateStreamOnFileEx.]

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

Sintassi

LWSTDAPI SHCreateStreamOnFileA(
  [in]  LPCSTR  pszFile,
  [in]  DWORD   grfMode,
  [out] IStream **ppstm
);

Parametri

[in] pszFile

Tipo: LPCTSTR

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

[in] grfMode

Tipo: DWORD

Uno o più valori di STGM usati per specificare la modalità di accesso ai file e il modo in cui l'oggetto che espone il flusso viene creato ed eliminato.

[out] ppstm

Tipo: ** IStream

Riceve un puntatore di 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.

Osservazioni

SHCreateStreamOnFileEx supporta completamente tutte le modalità di STGM e consente al chiamante di specificare gli attributi di file se si crea un nuovo file.

Nota

L'intestazione shlwapi.h definisce SHCreateStreamOnFile come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows XP [solo app desktop]
server minimo supportato	Windows Server 2003 [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	shlwapi.h
libreria	Shlwapi.lib
dll	Shlwapi.dll (versione 5.0 o successiva)

Condividi tramite