DavGetUNCFromHTTPPath-Funktion (davclnt.h)

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

Syntax

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

Parameter

[in] Url

Ein Zeiger auf eine Unicode-Zeichenfolge, die null endet und den HTTP-Pfad enthält. Diese Zeichenfolge kann in einem der folgenden Formate vorliegen, wobei Server der Servername und Pfad der Pfad zu einer Remotedatei oder einem Remoteverzeichnis auf dem Server ist:

• http:// serverpfad/
• http:// server
• \\http:// serverpfad/
• \\http:// server
• https:// serverpfad/
• https:// server
• \\https:// serverpfad/
• \\https:// server
• \\server\path
• \\server

[out] UncPath

Ein Zeiger auf einen vom Aufrufer zugewiesenen Puffer, der den UNC-Pfad als unicode-Zeichenfolge mit Null-Termin 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 UncPath-Parameter verweist. Wenn die Funktion erfolgreich ist, empfängt die Variable bei der Ausgabe die Anzahl der Zeichen, die in den Puffer kopiert wurden, einschließlich des abschließenden NULL-Zeichens. Wenn die Funktion mit ERROR_INSUFFICIENT_BUFFER fehlschlägt, empfängt die Variable bei der Ausgabe die Anzahl der Zeichen, die zum Speichern des UNC-Pfads erforderlich sind, einschließlich 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 UncPath-Parameter verweist, war nicht groß genug, um den UNC-Pfad zu speichern.

Anforderungen

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