Metodo IVssWMFiledesc::GetPath (vswriter.h)

  • Articolo

Il metodo GetPath ottiene il percorso della directory completo o il percorso UNC della condivisione file remota per ottenere l'elenco dei file descritti nell'oggetto IVssWMFiledesc corrente.

Un metodo di query ha usato questo percorso e una specifica di file per restituire l'oggetto IVssWMFiledesc corrente.

Sintassi

HRESULT GetPath(
  [out] BSTR *pbstrPath
);

Parametri

[out] pbstrPath

Indirizzo di una variabile allocata dal chiamante che riceve una stringa di caratteri wide con terminazione NULL specificando il percorso della directory completo o il percorso UNC della directory di condivisione file remota.

Il percorso può essere un nome di file lungo o breve e può usare il prefisso "\?". Per altre informazioni, vedere Denominazione di un file.

Gli utenti di questo metodo devono verificare se questo percorso termina con una barra rovesciata ("").

Valore restituito

Di seguito sono riportati i codici restituiti validi per questo metodo.

Valore Significato
S_OK
 Restituito correttamente le informazioni sul percorso.
E_INVALIDARG
 Uno dei valori dei parametri non è valido.
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

Windows 7, Windows Server 2008 R2, Windows Vista, Windows Server 2008, Windows XP e Windows Server 2003: Le condivisioni file remote non sono supportate fino a Windows 8 e Windows Server 2012.

Il chiamante deve chiamare SysFreeString per liberare la memoria mantenuta dal parametro pbstrPath .

Requisiti

   
Client minimo supportato Windows XP [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

IVssWMFiledesc