Metodo IVssSoftwareSnapshotProvider::GetSnapshotProperties (vsprov.h)

Articolo
03/13/2024

Ottiene le proprietà della copia shadow specificata.

Sintassi

HRESULT GetSnapshotProperties(
  [in]  VSS_ID            SnapshotId,
  [out] VSS_SNAPSHOT_PROP *pProp
);

Parametri

[in] SnapshotId

Identificatore di copia shadow.

[out] pProp

Indirizzo di una struttura VSS_SNAPSHOT_PROP allocata dal chiamante che riceve le proprietà della copia shadow. Il provider è responsabile dell'impostazione dei membri di questa struttura. Tutti i membri sono obbligatori ad eccezione di m_pwszExposedName e m_pwszExposedPath, che il provider può impostare su NULL. Il provider alloca memoria per tutti i membri stringa impostati nella struttura. Quando la struttura non è più necessaria, il chiamante è responsabile della liberazione di queste stringhe chiamando la funzione VssFreeSnapshotProperties .

Valore restituito

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

Valore	Significato
S_OK	Le informazioni richieste sono state restituite correttamente.
E_ACCESSDENIED	Il chiamante non dispone di privilegi di backup sufficienti o non è un amministratore.
E_INVALIDARG	Uno dei valori dei parametri non è valido.
E_OUTOFMEMORY	Il chiamante non è in memoria o in altre risorse di sistema.
VSS_E_OBJECT_NOT_FOUND	Impossibile trovare il volume specificato.
VSS_E_PROVIDER_VETO	Errore del provider. Il provider ha registrato l'errore nel registro eventi. Per altre informazioni, vedere Gestione degli eventi e degli errori in VSS.
VSS_E_UNEXPECTED	Errore imprevisto. Il codice di errore viene registrato nel file di log degli errori. Per altre informazioni, vedere Gestione degli eventi e degli errori in VSS. Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Questo valore non è supportato fino a Windows Server 2008 R2 e Windows 7. E_UNEXPECTED viene invece usato.

Commenti

Il chiamante deve impostare il contenuto della struttura VSS_SNAPSHOT_PROP su zero prima di chiamare il metodo GetSnapshotProperties .

Il provider è responsabile dell'allocazione e della liberazione delle stringhe nella struttura VSS_SNAPSHOT_PROP .

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	vsprov.h
Libreria	VssApi.lib

Vedi anche

IVssSoftwareSnapshotProvider

VssFreeSnapshotProperties

Condividi tramite