Método IVssComponent::GetNewTarget (vswriter.h)

El método GetNewTarget devuelve las nuevas ubicaciones de restauración de archivos para el componente o conjunto de componentes seleccionado. (Consulte Trabajar con la capacidad de selección y las rutas lógicas para obtener información sobre cómo seleccionar componentes).

Un escritor o un solicitante pueden llamar a este método.

Sintaxis

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

Parámetros

[in] iNewTarget

Número de índice del nuevo destino. El valor de este parámetro es un entero comprendido entre 0 y n-1, donde n es el número total de destinos nuevos asociados a un componente determinado. IVssComponent::GetNewTargetCount devuelve el valor de n.

[out] ppFiledesc

Puntero indirecto doble a un objeto IVssWMFiledesc que contiene la nueva información de ubicación de restauración de destino.

Valor devuelto

A continuación se muestran los códigos de retorno válidos para este método.

Valor	Significado
S_OK	Devolvió correctamente el valor del atributo.
E_INVALIDARG	Uno de los valores de parámetro no es válido.
E_OUTOFMEMORY	El autor de la llamada no tiene memoria u otros recursos del sistema.
VSS_E_INVALID_XML_DOCUMENT	El documento XML no es válido. Compruebe el registro de eventos para obtener más información. Para obtener más información, consulte Control de eventos y errores en VSS.
VSS_E_OBJECT_NOT_FOUND	No se encontró el elemento especificado.

Comentarios

Los nuevos destinos devueltos por GetNewTarget pueden ser aquellos no solo de los archivos del componente actual, sino de los archivos de cualquiera de sus subcomponentes no seleccionables.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	vswriter.h (incluya Vss.h, VsWriter.h)
Library	VssApi.lib

Consulte también

IVssComponent

IVssComponent::GetNewTargetCount