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
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 |