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

El método OpenStorage abre un objeto de almacenamiento existente con el nombre especificado en el modo de acceso especificado.

Sintaxis

HRESULT OpenStorage(
  [in]  const OLECHAR *pwcsName,
  [in]  IStorage      *pstgPriority,
  [in]  DWORD         grfMode,
  [in]  SNB           snbExclude,
  [in]  DWORD         reserved,
  [out] IStorage      **ppstg
);

Parámetros

[in] pwcsName

Un puntero a una cadena Unicode terminada en Null de carácter ancho que contiene el nombre del objeto de almacenamiento 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. Se omite si pstgPriority no es NULL.

[in] pstgPriority

Debe ser NULL. Un valor distinto de NULL devolverá STG_E_INVALIDPARAMETER.

[in] grfMode

Especifica el modo de acceso que se va a usar al abrir el objeto de almacenamiento. Para obtener descripciones de los valores posibles, vea Constantes STGM. Otros modos que elija deben por lo menos especificar STGM_SHARE_EXCLUSIVE al llamar a este método.

[in] snbExclude

Debe ser NULL. Un valor distinto de NULL devolverá STG_E_INVALIDPARAMETER.

[in] reserved

Reservado para uso futuro; debe ser cero.

[out] ppstg

Cuando se ejecuta correctamente, puntero a la ubicación de un puntero de IStorage al objeto de almacenamiento abierto. Este parámetro se establece en NULL si se produce un error.

Valor devuelto

Este método puede devolver uno de estos valores.

Código devuelto Descripción
S_OK El objeto de almacenamiento se abrió correctamente.
E_PENDING Solo almacenamiento asincrónico: la parte o todos los datos del almacenamiento no están disponibles actualmente.
STG_E_ACCESSDENIED No hay suficientes permisos para abrir el objeto de almacenamiento.
STG_E_FILENOTFOUND El objeto de almacenamiento con el nombre especificado no existe.
STG_E_INSUFFICIENTMEMORY No se abrió el objeto de almacenamiento 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 .
STG_E_INVALIDNAME No es un valor válido para pwcsName.
STG_E_INVALIDPOINTER El puntero especificado para el objeto de almacenamiento no era válido.
STG_E_INVALIDPARAMETER Uno de los parámetros no era válido.
STG_E_REVERTED El objeto de almacenamiento se ha invalidado mediante una operación de reversión encima de él en el árbol de transacciones.
STG_E_TOOMANYOPENFILES El objeto de almacenamiento no se creó porque hay demasiados archivos abiertos.
STG_S_CONVERTED La secuencia existente con el nombre especificado se reemplazó por un nuevo objeto de almacenamiento que contiene una única secuencia denominada CONTENTS. En modo directo, el nuevo almacenamiento se escribe inmediatamente en el disco. En el modo de transacción, el nuevo almacenamiento se escribe en un almacenamiento temporal en memoria y, posteriormente, se escribe en el disco cuando se confirma.

Comentarios

Si el parámetro pstgPriority es NULL, se omite. Si el parámetro pstgPriority no es NULL, es un puntero IStorage a una apertura anterior de un elemento del objeto de almacenamiento, normalmente uno que se abrió en modo de prioridad. El objeto de almacenamiento debe cerrarse y volver a abrirse según grfMode. Cuando se devuelve el método IStorage::OpenStorage , pstgPriority ya no es válido. Use el valor proporcionado en el parámetro ppstg .

Los objetos de almacenamiento se pueden abrir con STGM_DELETEONRELEASE, en cuyo caso el objeto se destruye cuando recibe su versión final. Esto es útil para crear objetos de almacenamiento temporales.

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::CreateStorage