Función SHCreateStreamOnFileA (shlwapi.h)
[SHCreateStreamOnFile está disponible para su uso en los sistemas operativos especificados en la sección Requisitos. En versiones posteriores podría modificarse o no estar disponible. 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
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.
[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
SHCreateStreamOnFileEx es totalmente compatible con todos los modos STGM y permite al autor de la llamada especificar atributos de archivo si se crea un nuevo archivo.
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 neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.
Requisitos
Requisito | Value |
---|---|
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 5.0 o posterior) |
Comentarios
https://aka.ms/ContentUserFeedback.
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea:Enviar y ver comentarios de