Compartilhar via


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

O método GetPath obtém o caminho de diretório totalmente qualificado ou o caminho UNC do compartilhamento de arquivos remoto para obter a lista de arquivos descritos no objeto IVssWMFiledesc atual.

Um método de consulta usou esse caminho e uma especificação de arquivo para retornar o objeto IVssWMFiledesc atual.

Sintaxe

HRESULT GetPath(
  [out] BSTR *pbstrPath
);

Parâmetros

[out] pbstrPath

O endereço de uma variável alocada pelo chamador que recebe uma cadeia de caracteres largos terminada em NULL especificando o caminho de diretório totalmente qualificado ou o caminho UNC do diretório de compartilhamento de arquivos remoto.

O caminho pode ser um nome de arquivo longo ou curto e pode usar o prefixo "\?". Para obter mais informações, confira Como nomear um arquivo.

Os usuários desse método precisam marcar para determinar se esse caminho termina com uma barra invertida ("").

Valor retornado

Veja a seguir os códigos de retorno válidos para esse método.

Valor Significado
S_OK
Retornou com êxito as informações do caminho.
E_INVALIDARG
Um dos valores de parâmetro não é válido.
E_OUTOFMEMORY
O chamador está sem memória ou outros recursos do sistema.
VSS_E_INVALID_XML_DOCUMENT
O documento XML não é válido. Verifique o log de eventos para obter detalhes. Para obter mais informações, consulte Tratamento de eventos e erros em VSS.
VSS_E_UNEXPECTED
Erro inesperado. O código de erro é registrado no arquivo de log de erros. Para obter mais informações, consulte Tratamento de eventos e erros em VSS.

Windows Server 2008, Windows Vista, Windows Server 2003 e Windows XP: Esse valor não tem suporte até o Windows Server 2008 R2 e o Windows 7. E_UNEXPECTED é usado.

Comentários

Windows 7, Windows Server 2008 R2, Windows Vista, Windows Server 2008, Windows XP e Windows Server 2003: Não há suporte para compartilhamentos de arquivos remotos até o Windows 8 e o Windows Server 2012.

O chamador deve chamar SysFreeString para liberar a memória mantida pelo parâmetro pbstrPath .

Requisitos

   
Cliente mínimo com suporte Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho vswriter.h (inclua Vss.h, VsWriter.h)
Biblioteca VssApi.lib

Confira também

IVssWMFiledesc