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

  • Artículo

El método GetLogicalPath recupera la ruta de acceso lógica de un componente del que depende el componente actual en la dependencia explícita del componente escritor.

Sintaxis

HRESULT GetLogicalPath(
  [out] BSTR *pbstrLogicalPath
);

Parámetros

[out] pbstrLogicalPath

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

Valor devuelto

Este método puede devolver uno de estos valores.

Valor Significado
S_OK
 Se devolvió correctamente la ruta de acceso lógica 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 pbstrLogicalPath 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, vea 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, vea 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 autor de la llamada debe liberar la memoria utilizada 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 se deben realizar copias de seguridad o restaurarse juntos.

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 del 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 (incluye Vss.h, VsWriter.h)
Library VssApi.lib

Consulte también

IVssWMComponent::GetDependency

IVssWMDependency

IVssWMDependency::GetComponentName

IVssWMDependency::GetWriterId