CreateUrlCacheEntryW-Funktion (wininet.h)

Artikel
03/13/2024

Erstellt einen lokalen Dateinamen zum Speichern des Cacheeintrags basierend auf der angegebenen URL und der Dateinamenerweiterung.

Syntax

BOOL CreateUrlCacheEntryW(
  [in]  LPCWSTR lpszUrlName,
  [in]  DWORD   dwExpectedFileSize,
  [in]  LPCWSTR lpszFileExtension,
  [out] LPWSTR  lpszFileName,
  [in]  DWORD   dwReserved
);

Parameter

[in] lpszUrlName

Zeiger auf einen Zeichenfolgenwert, der den Namen der URL enthält. Die Zeichenfolge muss einen Wert enthalten. Eine leere Zeichenfolge führt dazu, dass CreateUrlCacheEntry fehlschlägt. Darüber hinaus darf die Zeichenfolge keine Escapezeichen enthalten.

[in] dwExpectedFileSize

Erwartete Größe der Datei, die zum Speichern der Daten erforderlich ist, die der Quellentität in TCHARs entsprechen. Wenn die erwartete Größe unbekannt ist, legen Sie diesen Wert auf 0 (null) fest.

[in] lpszFileExtension

Zeiger auf einen Zeichenfolgenwert, der einen Erweiterungsnamen der Datei im lokalen Speicher enthält.

[out] lpszFileName

Zeiger auf einen Puffer, der den Dateinamen empfängt. Der Puffer sollte groß genug sein, um den Pfad der erstellten Datei zu speichern (mindestens MAX_PATH Zeichen).

[in] dwReserved

Dieser Parameter ist reserviert und muss 0 sein.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt die Funktion TRUE zurück.

Wenn die Funktion fehlschlägt, wird FALSE zurückgegeben. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Nachdem CreateUrlCacheEntry aufgerufen wurde, kann die Anwendung direkt in die Datei im lokalen Speicher schreiben. Wenn die Datei vollständig empfangen wird, sollte der Aufrufer CommitUrlCacheEntry aufrufen, um den Eintrag im Cache zu committen.

WinINet versucht, Unicode-Parameter gemäß der Systemcodepage zu decodieren. Anwendungen sollten sicherstellen, dass Unicode-Parameter für die Systemcodepage ordnungsgemäß codiert sind. Anwendungen können die Systemcodepage mit InternetSetOption festlegen, wie im folgenden Codebeispiel gezeigt:

DWORD CP_SHIFT_JIS = 932;  // ANSI/OEM  Japanese, Shift-JIS
InternetSetOption( hRequest, 
                   INTERNET_OPTION_CODEPAGE,
                   &amp;CP_SHIFT_JIS, 
                   sizeof(DWORD) );

Wenn der Unicode-Parameter nicht ordnungsgemäß für die Systemcodepage codiert ist, versucht WinINet die UTF8-Decodierung.

Wenn Elemente aus dem Cache abgerufen werden, muss die Systemcodepage, die zum Platzieren des Elements im Cache verwendet wurde, mit der aktuellen Systemcodepage für den Benutzer übereinstimmen. Bei Anwendungen, die unter IE6 und früher ausgeführt werden, versucht WinINet, wenn die Decodierung für die Systemcodepage fehlschlägt, UTF8-Decodierung.

Wie alle anderen Aspekte der WinINet-API kann diese Funktion nicht sicher innerhalb von DllMain oder den Konstruktoren und Destruktoren globaler Objekte aufgerufen werden.

Hinweis WinINet unterstützt keine Serverimplementierungen. Darüber hinaus sollte es nicht von einem Dienst verwendet werden. Verwenden Sie für Serverimplementierungen oder Dienste Microsoft Windows HTTP Services (WinHTTP).

Hinweis

Der wininet.h-Header definiert CreateUrlCacheEntry als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wininet.h
Bibliothek	Wininet.lib
DLL	Wininet.dll

Weitere Informationen

Zwischenspeichern

CommitUrlCacheEntry

WinINet-Funktionen

Share via