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

El método GetRestoreSubcomponent devuelve el subcomponente especificado asociado a un componente determinado.

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

Sintaxis

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

Parámetros

[in] iComponent

Índice del subcomponente. El valor de este parámetro es un entero entre 0 y n-1 inclusive, donde n es el número total de subcomponentes asociados a un componente determinado. IVssComponent::GetRestoreSubcomponentCount devuelve el valor de n.

[out] pbstrLogicalPath

Puntero a una cadena que contiene la ruta de acceso lógica del subcomponente. La ruta de acceso lógica no puede estar vacía al trabajar con subcomponentes.

[out] pbstrComponentName

Puntero a una cadena que contiene el nombre del subcomponente. Esta cadena no puede quedar vacía.

[out] pbRepair

Reservado para uso futuro.

Valor devuelto

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

Value	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

El llamador debe liberar la memoria mantenida por los parámetros pbstrLogicalPath y pbstrComponentName mediante una llamada a SysFreeString.

Requisitos

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