Condividi tramite

Metodo IVssFileShareSnapshotProvider::GetSnapshotProperties (vsprov.h)

Ottiene la struttura VSS_SNAPSHOT_PROP per uno snapshot di condivisione file.

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.

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 .

Il coordinatore vss chiama questo metodo durante la fase postSnapshot della creazione dello snapshot per recuperare il percorso di accesso allo snapshot (percorso UNC per gli snapshot di condivisione file). Il coordinatore chiama questo metodo dopo PreFinalCommitSnapshots e prima di richiamare PostSnapshot negli autori.

Requisiti

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

Vedi anche

IVssFileShareSnapshotProvider

  • Last updated on