Función WriteFmtUserTypeStg (ole2.h)

La función WriteFmtUserTypeStg escribe un formato de Portapapeles y un tipo de usuario en el objeto de almacenamiento.

Sintaxis

HRESULT WriteFmtUserTypeStg(
  [in] LPSTORAGE  pstg,
  [in] CLIPFORMAT cf,
  [in] LPOLESTR   lpszUserType
);

Parámetros

[in] pstg

Puntero de IStorage al objeto de almacenamiento donde se va a escribir la información.

[in] cf

Especifica el formato del Portapapeles que describe la estructura del área nativa del objeto de almacenamiento. La etiqueta de formato incluye la directiva para los nombres de secuencias y substorages dentro de este objeto de almacenamiento y las reglas para interpretar los datos dentro de esas secuencias.

[in] lpszUserType

Puntero a una cadena Unicode terminada en null que especifica el tipo de usuario actual del objeto. El valor de tipo de usuario, en sí, no puede ser NULL. Este es el tipo devuelto por el método IOleObject::GetUserType . Si esta función se transporta a una máquina remota en la que la clase de objeto no existe, este tipo de usuario almacenado persistentemente se puede mostrar al usuario en los cuadros de diálogo.

Valor devuelto

Esta función devuelve HRESULT.

Comentarios

Se debe llamar a la función WriteFmtUserTypeStg en la implementación de un objeto del método IPersistStorage::Save . También se debe llamar mediante objetos de nivel de documento que usan almacenamiento estructurado para su representación persistente en su secuencia de guardado.

Para leer la información guardada, las aplicaciones llaman a la función ReadFmtUserTypeStg .

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	ole2.h
Library	Ole32.lib
Archivo DLL	Ole32.dll
Conjunto de API	ext-ms-win-com-ole32-l1-1-3 (introducido en Windows 10, versión 10.0.10240)

Consulte también

IPersistStorage::Save

ReadFmtUserTypeStg