Funzione WriteFmtUserTypeStg (ole2.h)

La funzione WriteFmtUserTypeStg scrive un formato degli Appunti e un tipo di utente nell'oggetto di archiviazione.

Sintassi

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

Parametri

[in] pstg

Puntatore IStorage all'oggetto di archiviazione in cui devono essere scritte le informazioni.

[in] cf

Specifica il formato degli Appunti che descrive la struttura dell'area nativa dell'oggetto di archiviazione. Il tag di formato include i criteri per i nomi di flussi e sottostorage all'interno di questo oggetto di archiviazione e le regole per interpretare i dati all'interno di tali flussi.

[in] lpszUserType

Puntatore a una stringa Unicode con terminazione Null che specifica il tipo di utente corrente dell'oggetto. Il valore del tipo di utente stesso non può essere NULL. Questo è il tipo restituito dal metodo IOleObject::GetUserType . Se questa funzione viene trasportata in un computer remoto in cui la classe oggetto non esiste, questo tipo di utente archiviato in modo permanente può essere visualizzato all'utente nelle finestre di dialogo.

Valore restituito

Questa funzione restituisce HRESULT.

Commenti

La funzione WriteFmtUserTypeStg deve essere chiamata nell'implementazione di un oggetto del metodo IPersistStorage::Save . Deve essere chiamato anche da oggetti a livello di documento che usano l'archiviazione strutturata per la relativa rappresentazione permanente nella sequenza di salvataggio.

Per leggere le informazioni salvate, le applicazioni chiamano la funzione ReadFmtUserTypeStg .

Requisiti

Vedi anche

IPersistStorage::Save

ReadFmtUserTypeStg