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
S_OK	È stato restituito un percorso assoluto valido.
S_FALSE	La richiesta di salvataggio predefinita è stata restituita.
E_OUTOFMEMORY	L'operazione non è riuscita a causa di memoria insufficiente.
E_FAIL	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

Ipersistfile