Método IVssWMDependency::GetComponentName (vswriter.h)
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 |
|---|---|
|
Devolvió correctamente el nombre del componente del que depende el componente actual. |
|
No se puede encontrar ningún escritor que administre el componente del que depende el componente actual. |
|
El puntero pbstrComponentName apunta a la memoria sin asignar. |
|
El autor de la llamada no tiene memoria u otros recursos del sistema. |
|
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. |
|
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