Metodo IVssComponent::GetNewTarget (vswriter.h)

Il metodo GetNewTarget restituisce i nuovi percorsi di ripristino dei file per il componente o il set di componenti selezionato. Per informazioni sulla selezione dei componenti, vedere Uso della selezionabilità e dei percorsi logici .

Un writer o un richiedente può chiamare questo metodo.

Sintassi

HRESULT GetNewTarget(
  [in]  UINT           iNewTarget,
  [out] IVssWMFiledesc **ppFiledesc
);

Parametri

[in] iNewTarget

Numero di indice della nuova destinazione. Il valore di questo parametro è un numero intero compreso tra 0 e n-1 inclusi, dove n è il numero totale di nuove destinazioni associate a un determinato componente. Il valore di n viene restituito da IVssComponent::GetNewTargetCount.

[out] ppFiledesc

Puntatore indiretto doubly a un oggetto IVssWMFiledesc contenente le nuove informazioni sul percorso di ripristino di destinazione.

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

Le nuove destinazioni restituite da GetNewTarget possono essere quelle non solo dei file nel componente corrente, ma ai file in uno dei relativi sottocomponenti non selezionabili.

Requisiti

Requisito	Valore
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

IVssComponent::GetNewTargetCount