Metodo IVssWMDependency::GetLogicalPath (vswriter.h)
Il metodo GetLogicalPath recupera il percorso logico di un componente da cui dipende il componente corrente nella dipendenza esplicita del componente writer.
Sintassi
HRESULT GetLogicalPath(
[out] BSTR *pbstrLogicalPath
);
Parametri
[out] pbstrLogicalPath
Indirizzo di una variabile allocata dal chiamante che riceve una stringa di caratteri wide con terminazione NULL contenente il percorso logico del componente da cui dipende il componente corrente.
Valore restituito
Questo metodo può restituire uno di questi valori.
| Valore | Significato |
|---|---|
|
È stato restituito correttamente il percorso logico del componente da cui dipende il componente corrente. |
|
Non è possibile trovare alcun writer che gestisce il componente da cui dipende il componente corrente. |
|
Il puntatore pbstrLogicalPath punta alla memoria non allocata. |
|
Il chiamante non è in memoria o in altre risorse di sistema. |
|
Documento XML non valido. Per informazioni dettagliate, vedere il registro eventi. Per altre informazioni, vedere Gestione degli eventi e degli errori in VSS. |
|
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 da cui dipende. Una dipendenza indica semplicemente che il componente e i componenti da cui dipende 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 di gestione del componente da cui dipende il 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