Metodo IVssComponent::GetRestoreSubcomponent (vswriter.h)

Articolo
08/27/2023

Il metodo GetRestoreSubcomponent restituisce il sottocomponente specificato associato a un determinato componente.

Un writer o un richiedente può chiamare questo metodo.

Sintassi

HRESULT GetRestoreSubcomponent(
  [in]  UINT iComponent,
  [out] BSTR *pbstrLogicalPath,
  [out] BSTR *pbstrComponentName,
  [out] bool *pbRepair
);

Parametri

[in] iComponent

Indice del sottocomponente. Il valore di questo parametro è un numero intero compreso tra 0 e n-1 inclusi, dove n è il numero totale di sottocomponenti associati a un determinato componente. Il valore di n viene restituito da IVssComponent::GetRestoreSubcomponentCount.

[out] pbstrLogicalPath

Puntatore a una stringa contenente il percorso logico del sottocomponente. Il percorso logico non può essere vuoto quando si lavora con i sottocomponenti.

[out] pbstrComponentName

Puntatore a una stringa contenente il nome del sottocomponente. La stringa non può essere vuota.

[out] pbRepair

Riservato per utilizzi futuri.

Valore restituito

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

Valore	Significato
S_OK	È stato restituito correttamente il valore dell'attributo.
E_INVALIDARG	Uno dei valori dei parametri non è valido.
E_OUTOFMEMORY	Il chiamante non è in memoria o in altre risorse di sistema.
VSS_E_INVALID_XML_DOCUMENT	Documento XML non valido. Per informazioni dettagliate, vedere il registro eventi. Per altre informazioni, vedere Gestione degli eventi e degli errori in VSS.
VSS_E_OBJECT_NOT_FOUND	L'elemento specificato non è stato trovato.

Commenti

Il chiamante deve liberare la memoria contenuta nei parametri pbstrLogicalPath e pbstrComponentName chiamando SysFreeString.

Requisiti


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

Vedi anche

IVssComponent

Condividi tramite