Compartilhar via

Função DavGetHTTPFromUNCPath (davclnt.h)

  • Artigo

Converte o caminho UNC especificado em um caminho HTTP equivalente.

Sintaxe

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

Parâmetros

[in] UncPath

Um ponteiro para uma cadeia de caracteres Unicode terminada em nulo que contém o caminho UNC. Esse caminho deve estar no seguinte formato:

\\ server[@SSL][@port][\path]

onde

  • server é o nome do servidor.
  • @SSL é opcional e indica uma solicitação para uma conexão SSL.
  • port é um número de porta opcional. As portas padrão são 80 para http e 443 para https (SSL).
  • path é opcional e especifica um caminho para um arquivo ou diretório remoto no servidor.

[out] Url

Um ponteiro para um buffer alocado pelo chamador que recebe o caminho HTTP 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 HttpPath 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. 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 HTTP, incluindo o prefixo "http://" ou "https://" e o caractere NULL de terminação.

Retornar valor

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 HttpPath aponta não era grande o suficiente para armazenar o caminho HTTP.

Requisitos

Requisito Valor
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