Condividi tramite


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