Método IPersistFile::Load (objidl.h)

Abre el archivo especificado e inicializa un objeto del contenido del archivo.

Sintaxis

HRESULT Load(
  [in] LPCOLESTR pszFileName,
  [in] DWORD     dwMode
);

Parámetros

[in] pszFileName

Ruta de acceso absoluta del archivo que se va a abrir.

[in] dwMode

Modo de acceso que se va a usar al abrir el archivo. Los valores posibles se toman de la enumeración STGM . El método puede tratar este valor como una sugerencia, agregando permisos más restrictivos si es necesario. Si dwMode es 0, la implementación debe abrir el archivo con los permisos predeterminados que se usen cuando un usuario abra el archivo.

Valor devuelto

Este método puede devolver los valores siguientes.

Código devuelto	Descripción
S_OK	El método se completó correctamente.
E_OUTOFMEMORY	No se pudo cargar el objeto debido a una falta de memoria.
E_FAIL	No se pudo cargar el objeto por algún motivo distinto de la falta de memoria.

Comentarios

IPersistFile::Load carga el objeto del archivo especificado. Este método es solo para la inicialización y no muestra el objeto al usuario final. No es equivalente a lo que ocurre cuando un usuario selecciona el comando Abrir archivo .

Notas a los autores de llamadas

El método BindToObject de los monikers de archivo llama a este método para cargar un objeto durante una operación de enlace de moniker (cuando se ejecuta un objeto vinculado). Normalmente, las aplicaciones no llaman directamente a este método.

Notas para los implementadores

Dado que la información necesaria para abrir un archivo varía considerablemente de una aplicación a otra, el objeto en el que se implementa este método también debe abrir el archivo especificado por el parámetro pszFileName . Esto difiere de IPersistStorage::Load e IPersistStream::Load, en el que el autor de la llamada abre el almacenamiento o el flujo y, a continuación, pasa un puntero de flujo o almacenamiento abierto al objeto cargado.

Para una aplicación que normalmente usa archivos compuestos OLE, la implementación IPersistFile::Load simplemente puede llamar a la función StgOpenStorage para abrir el objeto de almacenamiento en el archivo especificado. A continuación, puede continuar con la inicialización normal. Las aplicaciones que no usan objetos de almacenamiento pueden realizar procedimientos normales de apertura de archivos.

Cuando se ha cargado el objeto, la implementación debe registrar el objeto en la tabla de objetos en ejecución (vea IRunningObjectTable::Register).

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	objidl.h

Consulte también

IPersistFile