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

  • Artículo

Guarda una copia del objeto en el archivo especificado.

Sintaxis

HRESULT Save(
  [in] LPCOLESTR pszFileName,
  [in] BOOL      fRemember
);

Parámetros

[in] pszFileName

Ruta de acceso absoluta del archivo al que se debe guardar el objeto. Si pszFileName es NULL, el objeto debe guardar sus datos en el archivo actual, si hay uno.

[in] fRemember

Indica si el parámetro pszFileName se va a usar como archivo de trabajo actual. Si es TRUE, pszFileName se convierte en el archivo actual y el objeto debe borrar su marca desfasada después de guardar. Si es FALSE, esta operación de guardado es una operación Guardar una copia como ... . En este caso, el archivo actual no cambia y el objeto no debe borrar su marca desfasada. Si pszFileName es NULL, la implementación debe omitir la marca fRemember .

Valor devuelto

Si el objeto se guardó correctamente, el valor devuelto se S_OK. De lo contrario, es S_FALSE. Este método también puede devolver varios errores de almacenamiento.

Comentarios

Se puede llamar a este método para guardar un objeto en el archivo especificado de tres maneras:

El implementador debe detectar qué tipo de operación de guardado solicita el autor de la llamada. Si el parámetro pszFileName es NULL, se solicita un save . Si el parámetro pszFileName no es NULL, use el valor del parámetro fRemember para distinguir entre un guardar como y un guardar como.

En las operaciones Guardar o Guardar como , IPersistFile::Save borra la marca desfasada interna después de guardar y envía notificaciones IAdviseSink::OnSave a cualquier conexión de asesoramiento (consulte también IOleAdviseHolder::SendOnSave). Además, en estas operaciones, el objeto está en modo NoScribble hasta que recibe una llamada IPersistFile::SaveCompleted . En el modo NoScribble, el objeto no debe escribir en el archivo.

En el escenario Guardar como , la implementación también debe enviar notificaciones IAdviseSink::OnRename a cualquier conexión de asesoramiento (consulte también IOleAdviseHolder::SendOnRename).

En el escenario Guardar una copia como , la implementación no borra la marca desfasada interna después de guardar.

Notas a los autores de llamadas

OLE no llama a IPersistFile::Save. Normalmente, las aplicaciones no lo llamarían a menos que guarden un objeto en un archivo directamente, que generalmente queda al usuario final.

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