Freigeben über


CreateUrlCacheEntryA-Funktion (wininet.h)

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

Syntax

BOOL CreateUrlCacheEntryA(
  [in]  LPCSTR lpszUrlName,
  [in]  DWORD  dwExpectedFileSize,
  [in]  LPCSTR lpszFileExtension,
  [out] LPSTR  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 benötigt wird, die der Quellentität in TCHARs entsprechen. Wenn die erwartete Größe unbekannt ist, legen Sie diesen Wert auf 0 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 (mindestens MAX_PATH Zeichen länge) zu speichern.

[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, gibt sie FALSE zurück. 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 commiten.

WinINet versucht, Unicode-Parameter entsprechend 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,
                   &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 die UTF8-Decodierung, wenn die Decodierung für die Systemcodepage fehlschlägt.

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 aus 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 nicht codierungsneutralem Code 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