Metodo IVssCreateExpressWriterMetadata::AddComponentDependency (vswriter.h)

Articolo
03/03/2024

Consente a un writer express di indicare che un componente gestito ha una dipendenza esplicita del componente writer; ovvero, un altro componente (possibilmente gestito da un altro writer) deve essere eseguito il backup e il ripristino con esso.

Sintassi

HRESULT AddComponentDependency(
  [in] LPCWSTR wszForLogicalPath,
  [in] LPCWSTR wszForComponentName,
  [in] VSS_ID  onWriterId,
  [in] LPCWSTR wszOnLogicalPath,
  [in] LPCWSTR wszOnComponentName
);

Parametri

[in] wszForLogicalPath

Stringa di caratteri wide con terminazione null contenente il percorso logico del componente (gestito dal writer express) che richiede una dipendenza.

[in] wszForComponentName

Stringa di caratteri wide con terminazione null contenente il componente (gestito dal writer express) che richiede una dipendenza.

[in] onWriterId

Valore VSS_ID (GUID) che specifica la classe writer del writer express che gestisce il componente in base al quale dipende il componente corrente.

[in] wszOnLogicalPath

Percorso logico del componente (gestito dal writer express identificato da onWriterId) in cui dipende il componente corrente.

[in] wszOnComponentName

Nome del componente (gestito dal writer express identificato da onWriterId) in cui dipende il componente corrente.

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.
VSS_E_INVALID_XML_DOCUMENT	Il documento XML non è valido. Controllare il registro eventi per informazioni dettagliate. Per altre informazioni, vedere Gestione degli eventi e degli errori in VSS.
VSS_E_OBJECT_NOT_FOUND	Il componente specificato da wszForLogicalPath e wszForComponentName non esiste.
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.

Requisiti

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

Vedi anche

IVssCreateExpressWriterMetadata

Condividi tramite