Método IVssWMDependency::GetComponentName (vswriter.h)

  • Artículo

El método GetComponentName recupera el nombre de un componente del que depende el componente actual en una dependencia explícita de writer-component.

Sintaxis

HRESULT GetComponentName(
  BSTR *pbstrComponentName
);

Parámetros

pbstrComponentName

Dirección de una variable asignada por el autor de la llamada que recibe una cadena de caracteres anchos terminada en NULL que contiene el nombre del componente del que depende el componente actual.

Valor devuelto

Este método puede devolver uno de estos valores.

Valor Significado
S_OK
 Devolvió correctamente el nombre del componente del que depende el componente actual.
S_FALSE
 No se puede encontrar ningún escritor que administre el componente del que depende el componente actual.
E_INVALIDARG
 El puntero pbstrComponentName apunta a la memoria sin asignar.
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_UNEXPECTED
 error inesperado. El código de error se registra en el archivo de registro de errores. Para obtener más información, consulte Control de eventos y errores en VSS.

Windows Server 2008, Windows Vista, Windows Server 2003 y Windows XP: Este valor no se admite hasta Windows Server 2008 R2 y Windows 7. E_UNEXPECTED se usa en su lugar.

Comentarios

El llamador debe liberar la memoria usada por la cadena devuelta llamando a SysFreeString.

Una dependencia no indica un orden de preferencia entre el componente con las dependencias documentadas y los componentes de los que depende. Una dependencia simplemente indica que el componente y los componentes de los que depende siempre deben realizarse copias de seguridad o restaurarse juntas.

Es posible tener varias instancias de una clase de escritor determinada; sin embargo, la ruta de acceso lógica y el nombre de cualquier componente deben ser únicos.

Si hay varias instancias de una clase de escritor, será necesario usar la información de ruta de acceso lógica y nombre de componente para identificar la instancia que administra el componente en el que depende el componente actual.

Requisitos

Requisito Value
Cliente mínimo compatible Windows Vista [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

IVssWMComponent::GetDependency

IVssWMDependency

IVssWMDependency::GetLogicalPath

IVssWMDependency::GetWriterId