Método ITextDocument::Save (tom.h)

Artículo
08/26/2023

Guarda el documento.

Sintaxis

HRESULT Save(
  [in] VARIANT *pVar,
  [in] long    Flags,
  [in] long    CodePage
);

Parámetros

[in] pVar

Tipo: VARIANT*

Destino de guardado. Este parámetro es variant, que puede ser un nombre de archivo o NULL.

[in] Flags

Tipo: long

Marcas de creación, apertura, uso compartido y conversión de archivos. Para obtener una lista de los valores posibles, vea ITextDocument::Open.

[in] CodePage

Tipo: long

Página de códigos especificada. Los valores comunes son CP_ACP (cero: página de códigos ANSI del sistema), 1200 (Unicode) y 1208 (UTF-8).

Valor devuelto

Tipo: HRESULT

El valor devuelto puede ser un valor HRESULT que corresponde a un código de error del sistema o a un código de error COM, incluidos uno de los valores siguientes.

Código devuelto	Descripción
S_OK	El método se realiza correctamente.
E_INVALIDARG	Argumento no válido.
E_OUTOFMEMORY	Memoria insuficiente.
E_NOTIMPL	Característica no implementada.

Comentarios

Para usar los parámetros especificados para abrir el archivo, use cero valores para los parámetros.

Si pVar es nulo o falta, se usa el nombre de archivo proporcionado por el nombre de este documento. Si faltan ambos o son NULL, se produce un error en el método.

Si pVar especifica un nombre de archivo, ese nombre debe reemplazar la propiedad Name actual. Del mismo modo, los argumentos Flags y CodePage pueden sobresule los proporcionados en el método ITextDocument::Open y definir los valores que se usarán para los archivos creados con el método ITextDocument::New .

Los archivos de texto sin formato Unicode deben guardarse con la marca de orden de bytes Unicode (0xFEFF) como primer carácter. Este carácter debe quitarse cuando se lee el archivo; es decir, solo se usa para importar o exportar para identificar el texto sin formato como Unicode e identificar el orden de bytes de ese texto. El Bloc de notas de Microsoft adoptó esta convención, que ahora recomienda el estándar Unicode.

Requisitos


Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	tom.h
Archivo DLL	Msftedit.dll