Funzione DavGetHTTPFromUNCPath (davclnt.h)

Converte il percorso UNC specificato in un percorso HTTP equivalente.

Sintassi

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

Parametri

[in] UncPath

Puntatore a una stringa Unicode con terminazione null contenente il percorso UNC. Questo percorso deve essere nel formato seguente:

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

dove

• server è il nome del server.
• @SSL è facoltativo e indica una richiesta per una connessione SSL.
• la porta è un numero di porta facoltativo. Le porte standard sono 80 per http e 443 per https (SSL).
• il percorso è facoltativo e specifica un percorso di un file o una directory remota nel server.

[out] Url

Puntatore a un buffer allocato del chiamante che riceve il percorso HTTP come stringa Unicode con terminazione null.

[in, out] lpSize

Puntatore a una variabile che in input specifica le dimensioni massime, in caratteri Unicode, del buffer a cui punta il parametro HttpPath . Se la funzione ha esito positivo, nell'output la variabile riceve il numero di caratteri copiati nel buffer. Se la funzione ha esito negativo con ERROR_INSUFFICIENT_BUFFER, nell'output la variabile riceve il numero di caratteri necessari per archiviare il percorso HTTP, incluso il prefisso "http://" o "https://" e il carattere NULL terminante.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è ERROR_SUCCESS.

Se la funzione ha esito negativo, il valore restituito è un codice di errore di sistema, ad esempio il valore seguente.

Requisiti