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