Compartilhar via

Função DavGetUNCFromHTTPPath (davclnt.h)

  • Artigo

Converte o caminho HTTP especificado em um caminho UNC equivalente.

Sintaxe

DWORD DavGetUNCFromHTTPPath(
  [in]      LPCWSTR Url,
  [out]     LPWSTR  UncPath,
  [in, out] LPDWORD lpSize
);

Parâmetros

[in] Url

Um ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém o caminho HTTP. Essa cadeia de caracteres pode estar em qualquer um dos seguintes formatos, em que o servidor é o nome do servidor e o caminho é o caminho para um arquivo ou diretório remoto no servidor:

  • http://caminhodo servidor/
  • http:// server
  • \\http://caminho do servidor/
  • \\http:// server
  • https:// caminho do/ servidor
  • https:// server
  • \\https://caminhodo servidor/
  • \\https:// server
  • \\server\path
  • \\server

[out] UncPath

Um ponteiro para um buffer alocado pelo chamador que recebe o caminho UNC como uma cadeia de caracteres Unicode terminada em nulo.

[in, out] lpSize

Um ponteiro para uma variável que na entrada especifica o tamanho máximo, em caracteres Unicode, do buffer para o qual o parâmetro UncPath aponta. Se a função for bem-sucedida, na saída, a variável receberá o número de caracteres que foram copiados para o buffer, incluindo o caractere NULL de terminação. Se a função falhar com ERROR_INSUFFICIENT_BUFFER, na saída a variável receberá o número de caracteres necessários para armazenar o caminho UNC, incluindo o caractere NULL de terminação.

Valor retornado

Se a função obtiver êxito, o valor retornado será ERROR_SUCCESS.

Se a função falhar, o valor retornado será um código de erro do sistema, como o valor a seguir.

Código de retorno Descrição
ERROR_INSUFFICIENT_BUFFER
 O buffer para o qual o parâmetro UncPath aponta não era grande o suficiente para armazenar o caminho UNC.

Requisitos

   
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho davclnt.h
Biblioteca Netapi32.lib
DLL Netapi32.dll