Método IStorage::OpenStream (objidl.h)

El método OpenStream abre un objeto de secuencia existente dentro de este objeto de almacenamiento en el modo de acceso especificado.

Sintaxis

HRESULT OpenStream(
  [in]  const OLECHAR *pwcsName,
  [in]  void          *reserved1,
  [in]  DWORD         grfMode,
  [in]  DWORD         reserved2,
  [out] IStream       **ppstm
);

Parámetros

[in] pwcsName

Puntero a una cadena Unicode terminada en null de caracteres anchos que contiene el nombre de la secuencia que se va a abrir. Los caracteres 000 a 01f, que actúan como el primer carácter del nombre de la secuencia/almacenamiento, se reservan para uso de OLE. Es una restricción de archivo compuesto, no una restricción de almacenamiento estructurado.

[in] reserved1

Reservado para uso futuro; debe ser NULL.

[in] grfMode

Especifica el modo de acceso que se va a asignar a la secuencia abierta. Para obtener más información y descripciones de los valores posibles, vea StGM Constants. Otros modos que elija deben especificar al menos STGM_SHARE_EXCLUSIVE al llamar a este método en la implementación de archivo compuesto.

[in] reserved2

Reservado para uso futuro; debe ser cero.

[out] ppstm

Puntero a la variable de puntero IStream que recibe el puntero de interfaz al objeto de secuencia recién abierto. Si se produce un error, *ppstm debe establecerse en NULL.

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto	Descripción
S_OK	La secuencia se abrió correctamente.
E_PENDING	Solo almacenamiento asincrónico: la parte o todos los datos del flujo no están disponibles actualmente.
STG_E_ACCESSDENIED	No hay permisos suficientes para abrir el flujo.
STG_E_FILENOTFOUND	La secuencia con el nombre especificado no existe.
STG_E_INSUFFICIENTMEMORY	La secuencia no se abrió debido a una falta de memoria.
STG_E_INVALIDFLAG	El valor especificado para el parámetro grfMode no es un valor de constantes STGM válido.
STG_E_INVALIDFUNCTION	No se admite la combinación especificada de marcas en el parámetro grfMode ; Por ejemplo, cuando se llama a este método sin la marca STGM_SHARE_EXCLUSIVE.
STG_E_INVALIDNAME	Valor no válido para pwcsName.
STG_E_INVALIDPOINTER	El puntero especificado para el objeto de secuencia no era válido.
STG_E_INVALIDPARAMETER	Uno de los parámetros no era válido.
STG_E_REVERTED	Una operación de reversión por encima de él ha invalidado el objeto de almacenamiento en el árbol de transacciones.
STG_E_TOOMANYOPENFILES	La secuencia no se abrió porque hay demasiados archivos abiertos.

Comentarios

IStorage::OpenStream abre un objeto de secuencia existente dentro de este objeto de almacenamiento en el modo de acceso especificado en grfMode. Existen restricciones en los permisos que se pueden proporcionar en grfMode. Por ejemplo, los permisos de este objeto de almacenamiento restringen los permisos en sus secuencias. En general, las restricciones de acceso en los flujos deben ser más estrictas que las de sus almacenamientos primarios. Las secuencias de archivos compuestos deben abrirse con STGM_SHARE_EXCLUSIVE.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	Windows 2000 Server [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	objidl.h
Library	Uuid.lib
Archivo DLL	Ole32.dll

Consulte también

IStorage: implementación de archivos compuestos

IStorage::CreateStream

Istream