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
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 2000 Professional [solo app desktop] |
| Server minimo supportato | Windows 2000 Server [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | ole2.h |
| Libreria | Ole32.lib |
| DLL | Ole32.dll |
| Set di API | ext-ms-win-com-ole32-l1-1-3 (introdotto in Windows 10, versione 10.0.10240) |