Metodo IPersistFile::GetCurFile (objidl.h)
Recupera il nome corrente del file associato all'oggetto . Se non è presente alcun file di lavoro corrente, questo metodo recupera la richiesta di salvataggio predefinita per l'oggetto.
Sintassi
HRESULT GetCurFile(
[out] LPOLESTR *ppszFileName
);
Parametri
[out] ppszFileName
Percorso del file corrente o del prompt del nome file predefinito ,ad esempio *.txt). Se si verifica un errore, ppszFileName è impostato su NULL.
Valore restituito
Questo metodo può restituire i valori seguenti.
Codice restituito | Descrizione |
---|---|
|
È stato restituito un percorso assoluto valido. |
|
La richiesta di salvataggio predefinita è stata restituita. |
|
L'operazione non è riuscita a causa di memoria insufficiente. |
|
L'operazione non è riuscita a causa di un motivo diverso da memoria insufficiente. |
Commenti
Questo metodo alloca la memoria per la stringa restituita nel parametro ppszFileName usando il metodo IMalloc::Alloc . Il chiamante è responsabile della chiamata del metodo IMalloc::Free per liberare la stringa. Sia il chiamante che questo metodo usano l'allocatore attività OLE fornito da una chiamata a CoGetMalloc.
Il nome file restituito in ppszFileName è il nome specificato in una chiamata a IPersistFile::Load quando il documento è stato caricato; o in IPersistFile::SaveCompleted se il documento è stato salvato in un file diverso.
Se l'oggetto non dispone di un file di lavoro corrente, deve fornire la richiesta predefinita che verrà visualizzata in una finestra di dialogo Salva con nome. Ad esempio, la richiesta di salvataggio predefinita per un oggetto elaboratore di testo potrebbe essere
"*.txt".
Note ai chiamanti
OLE non chiama il metodo GetCurFile . Le applicazioni non chiamerebbero questo metodo a meno che non chiamino anche i metodi di salvataggio di questa interfaccia.Nel salvataggio dell'oggetto, è possibile chiamare questo metodo prima di chiamare IPersistFile::Save per determinare se l'oggetto dispone di un file associato. Se questo metodo restituisce S_OK, è possibile chiamare IPersistFile::Save con un nome file NULL e un valore TRUE per il parametro fRemember per indicare all'oggetto di salvarlo nel file corrente. Se questo metodo restituisce S_FALSE, è possibile utilizzare la richiesta di salvataggio restituita nel parametro ppszFileName per chiedere all'utente finale di specificare un nome file. È quindi possibile chiamare IPersistFile::Save con il nome file immesso dall'utente per eseguire un'operazione Salva con nome.
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 | objidl.h |
Vedi anche
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per