Metodo IVssWMDependency::GetComponentName (vswriter.h)

Articolo
08/27/2023

Il metodo GetComponentName recupera il nome di un componente che il componente corrente dipende da in una dipendenza del componente writer esplicita.

Sintassi

HRESULT GetComponentName(
  BSTR *pbstrComponentName
);

Parametri

pbstrComponentName

Indirizzo di una variabile allocata dal chiamante che riceve una stringa di caratteri wide con terminazione NULL contenente il nome del componente a seconda del componente corrente.

Valore restituito

Questo metodo può restituire uno di questi valori.

Valore	Significato
S_OK	Restituito correttamente il nome del componente a seconda del componente corrente.
S_FALSE	Non è possibile trovare alcun writer che gestisce il componente a seconda del componente corrente.
E_INVALIDARG	Il puntatore pbstrComponentName punta alla memoria non allocata.
E_OUTOFMEMORY	Il chiamante non è in memoria o altre risorse di sistema.
VSS_E_INVALID_XML_DOCUMENT	Il documento XML non è valido. Controllare il registro eventi per informazioni dettagliate. Per altre informazioni, vedere Gestione degli eventi e degli errori in VSS.
VSS_E_UNEXPECTED	Errore imprevisto. Il codice di errore viene registrato nel file di log degli errori. Per altre informazioni, vedere Gestione degli eventi e degli errori in VSS. Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Questo valore non è supportato fino a Windows Server 2008 R2 e Windows 7. E_UNEXPECTED viene invece usato.

Commenti

Il chiamante deve liberare la memoria usata dalla stringa restituita chiamando SysFreeString.

Una dipendenza non indica un ordine di preferenza tra il componente con le dipendenze documentate e i componenti che dipende. Una dipendenza indica semplicemente che il componente e i componenti a seconda di devono essere sempre sottoposti a backup o ripristinati insieme.

È possibile avere più istanze di una determinata classe writer; Tuttavia, il percorso logico e il nome di qualsiasi componente devono essere univoci.

Se sono presenti più istanze di una classe writer, sarà necessario usare le informazioni sul percorso logico e sul nome del componente per identificare l'istanza che gestisce il componente a seconda del componente corrente.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	vswriter.h (include Vss.h, VsWriter.h)
Libreria	VssApi.lib

Vedi anche

IVssWMComponent::GetDependency

IVssWMDependency

IVssWMDependency::GetLogicalPath

IVssWMDependency::GetWriterId

Condividi tramite