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

  • Artículo

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