Método IVssWMFiledesc::GetPath (vswriter.h)

  • Artículo

El método GetPath obtiene la ruta de acceso completa del directorio o la ruta de acceso UNC del recurso compartido de archivos remotos para obtener la lista de archivos descritos en el objeto IVssWMFiledesc actual.

Un método de consulta usó esta ruta de acceso y una especificación de archivo para devolver el objeto IVssWMFiledesc actual.

Sintaxis

HRESULT GetPath(
  [out] BSTR *pbstrPath
);

Parámetros

[out] pbstrPath

Dirección de una variable asignada por el autor de la llamada que recibe una cadena de caracteres anchos terminada en NULL que especifica la ruta de acceso de directorio completa o la ruta de acceso UNC del directorio del recurso compartido de archivos remoto.

La ruta de acceso puede ser un nombre de archivo largo o corto y puede usar el prefijo "\?". Para obtener más información, vea Asignación de nombre de un archivo.

Los usuarios de este método deben comprobar si esta ruta termina con una barra diagonal inversa ("").

Valor devuelto

A continuación se muestran los códigos de retorno válidos para este método.

Value Significado
S_OK
 Devolvió correctamente la información de la ruta de acceso.
E_INVALIDARG
 Uno de los valores de parámetro no es válido.
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, consulte 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, 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

Windows 7, Windows Server 2008 R2, Windows Vista, Windows Server 2008, Windows XP y Windows Server 2003: Los recursos compartidos de archivos remotos no se admiten hasta Windows 8 y Windows Server 2012.

El autor de la llamada debe llamar a SysFreeString para liberar la memoria que mantiene el parámetro pbstrPath .

Requisitos

   
Cliente mínimo compatible Windows XP [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

IVssWMFiledesc