Función SHCreateStreamOnFileA (shlwapi.h)

[ SHCreateStreamOnFile está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. Puede modificarse o no estar disponible en versiones posteriores. En su lugar, use SHCreateStreamOnFileEx.]

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

Sintaxis

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

Parámetros

[in] pszFile

Tipo: LPCTSTR de

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

[in] grfMode

Tipo: DWORD de

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

[out] ppstm

Tipo: de IStream de

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

Valor devuelto

Tipo: HRESULT

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

Observaciones

SHCreateStreamOnFileEx admite completamente todos los modos de STGM y permite al autor de la llamada especificar atributos de archivo si crea un archivo nuevo.

Nota

El encabezado shlwapi.h define SHCreateStreamOnFile como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows XP [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows Server 2003 [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	shlwapi.h
biblioteca de	Shlwapi.lib
DLL de	Shlwapi.dll (versión 5.0 o posterior)