Funzione SHCreateStreamOnFileA (shlwapi.h)

Articolo
03/02/2024

[SHCreateStreamOnFile è disponibile per l'uso nei sistemi operativi specificati nella sezione Requisiti. È possibile che in versioni successive sia stata modificata o non sia più disponibile. 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 STGM utilizzati per specificare la modalità di accesso ai file e la modalità di creazione ed eliminazione dell'oggetto che espone il flusso.

[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

SHCreateStreamOnFileEx supporta completamente tutte le modalità 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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Requisito	Valore
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 5.0 o successiva)

Condividi tramite