Función SHCreateStreamOnFileEx (shlwapi.h)

Abre o crea un archivo y recupera una secuencia para leer o escribir en ese archivo.

Sintaxis

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

Puntero a una cadena terminada en null que especifica el nombre de archivo.

[in] grfMode

Tipo: DWORD

Uno o varios valores STGM que se usan para especificar el modo de acceso a archivos y cómo se crea y elimina el objeto que expone la secuencia.

[in] dwAttributes

Tipo: DWORD

Uno o más valores de marca que especifican atributos de archivo en caso de que se cree un nuevo archivo. Para obtener una lista completa de los valores posibles, consulte el parámetro dwFlagsAndAttributes de la función CreateFile .

[in] fCreate

Tipo: BOOL

Valor BOOL que ayuda a especificar, junto con grfMode, cómo se deben tratar los archivos existentes al crear la secuencia. Para obtener información detallada, vea la sección Comentarios de.

[in, optional] pstmTemplate

Tipo: IStream*

Reservado.

[out] ppstm

Tipo: IStream**

Recibe un puntero de interfaz IStream para la secuencia asociada al archivo.

Valor devuelto

Tipo: HRESULT

Si esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

La función SHCreateStreamOnFileEx extiende la semántica de las marcas STGM y genera el mismo efecto que llamar a la función CreateFile .

Los parámetros grfMode y fCreate funcionan juntos para especificar cómo debe comportarse la función con respecto a los archivos existentes.

grfMode	fCreate	¿El archivo existe?	Comportamiento
STGM_CREATE	Omitido	Sí	El archivo se vuelve a crear.
STGM_CREATE	Omitido	No	Se crea el archivo.
STGM_FAILIFTHERE	FALSE	Sí	El archivo se abre.
STGM_FAILIFTHERE	FALSE	No	Se produce un error en la llamada.
STGM_FAILIFTHERE	TRUE	Sí	Se produce un error en la llamada.
STGM_FAILIFTHERE	TRUE	No	Se crea el archivo.

Requisitos

Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	shlwapi.h
Library	Shlwapi.lib
Archivo DLL	Shlwapi.dll (versión 6.0 o posterior)