Freigeben über

DavGetHTTPFromUNCPath-Funktion (davclnt.h)

  • Artikel

Konvertiert den angegebenen UNC-Pfad in einen entsprechenden HTTP-Pfad.

Syntax

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

Parameter

[in] UncPath

Ein Zeiger auf eine Unicode-Zeichenfolge mit Null-Termin, die den UNC-Pfad enthält. Dieser Pfad muss das folgende Format aufweisen:

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

where

  • server ist der Servername.
  • @SSL ist optional und gibt eine Anforderung für eine SSL-Verbindung an.
  • port ist eine optionale Portnummer. Die Standardports sind 80 für HTTP und 443 für HTTPS (SSL).
  • path ist optional und gibt einen Pfad zu einer Remotedatei oder einem Remoteverzeichnis auf dem Server an.

[out] Url

Ein Zeiger auf einen vom Aufrufer zugeordneten Puffer, der den HTTP-Pfad als mit NULL endende Unicode-Zeichenfolge empfängt.

[in, out] lpSize

Ein Zeiger auf eine Variable, die bei der Eingabe die maximale Größe des Puffers in Unicode-Zeichen angibt, auf den der HttpPath-Parameter verweist. Wenn die Funktion erfolgreich ist, empfängt die Variable bei der Ausgabe die Anzahl der Zeichen, die in den Puffer kopiert wurden. Wenn die Funktion mit ERROR_INSUFFICIENT_BUFFER fehlschlägt, empfängt die Variable bei der Ausgabe die Anzahl von Zeichen, die zum Speichern des HTTP-Pfads erforderlich sind, einschließlich des Präfixes "http://" oder "https://" und des abschließenden NULL-Zeichens.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert ERROR_SUCCESS.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein Systemfehlercode, z. B. der folgende Wert.

Rückgabecode Beschreibung
ERROR_INSUFFICIENT_BUFFER
 Der Puffer, auf den der HttpPath-Parameter verweist, war nicht groß genug, um den HTTP-Pfad zu speichern.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile davclnt.h
Bibliothek Netapi32.lib
DLL Netapi32.dll