Metodo IVssComponentEx::GetRestoreName (vswriter.h)

Ottiene il nome logico assegnato a un componente che viene ripristinato.

Sintassi

HRESULT GetRestoreName(
  [out] BSTR *pbstrName
);

Parametri

[out] pbstrName

Indirizzo di una variabile allocata dal chiamante che riceve una stringa di caratteri wide con terminazione null contenente il nome di ripristino per il componente.

Valore restituito

Di seguito sono riportati i codici restituiti validi per questo metodo.

Valore	Significato
S_OK	L'operazione è stata completata.
E_INVALIDARG	Uno dei valori dei parametri non è valido.
E_OUTOFMEMORY	Il chiamante non è in memoria o altre risorse di sistema.

Commenti

Il metodo GetRestoreName può essere chiamato solo durante un'operazione di ripristino.

Se la chiamata a GetRestoreName ha esito positivo, il chiamante è responsabile della liberazione della stringa restituita nel parametro pbstrName chiamando la funzione SysFreeString .

Un writer indica che supporta questo metodo impostando il flag VSS_BS_RESTORE_RENAME nella maschera dello schema di backup.

Per altre informazioni, vedere Impostazione delle opzioni di ripristino di VSS.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	vswriter.h (include Vss.h, VsWriter.h)
Libreria	VssApi.lib

Vedi anche

IVssBackupComponentsEx2::SetRestoreName

IVssComponentEx

VSS_BACKUP_SCHEMA