CreateUrlCacheEntryA, fonction (wininet.h)

Article
11/20/2024

Crée un nom de fichier local pour enregistrer l’entrée de cache en fonction de l’URL spécifiée et de l’extension de nom de fichier.

Syntaxe

BOOL CreateUrlCacheEntryA(
  [in]  LPCSTR lpszUrlName,
  [in]  DWORD  dwExpectedFileSize,
  [in]  LPCSTR lpszFileExtension,
  [out] LPSTR  lpszFileName,
  [in]  DWORD  dwReserved
);

Paramètres

[in] lpszUrlName

Pointeur vers une valeur de chaîne qui contient le nom de l’URL. La chaîne doit contenir une valeur ; une chaîne vide entraîne l’échec de CreateUrlCacheEntry. En outre, la chaîne ne doit contenir aucun caractère d’échappement.

[in] dwExpectedFileSize

Taille attendue du fichier nécessaire pour stocker les données qui correspondent à l’entité source, dans TCHAR. Si la taille attendue est inconnue, définissez cette valeur sur zéro.

[in] lpszFileExtension

Pointeur vers une valeur de chaîne qui contient un nom d’extension du fichier dans le stockage local.

[out] lpszFileName

Pointeur vers une mémoire tampon qui reçoit le nom du fichier. La mémoire tampon doit être suffisamment grande pour stocker le chemin du fichier créé (au moins MAX_PATH caractères de longueur).

[in] dwReserved

Ce paramètre est réservé et doit être 0.

Valeur de retour

Si la fonction réussit, la fonction retourne TRUE.

Si la fonction échoue, elle retourne FALSE. Pour obtenir des informations d’erreur étendues, appelez GetLastError.

Remarques

Une fois createUrlCacheEntry est appelée, l’application peut écrire directement dans le fichier dans le stockage local. Lorsque le fichier est complètement reçu, l’appelant doit appeler CommitUrlCacheEntry pour valider l’entrée dans le cache.

WinINet tente de décoder les paramètres Unicode en fonction de la page de codes système. Les applications doivent s’assurer que les paramètres Unicode sont correctement codés pour la page de codes système. Les applications peuvent définir la page de codes système avec InternetSetOption comme illustré dans l’exemple de code suivant :

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

Si le paramètre Unicode n’est pas correctement encodé dans la page de codes système, WinINet tente de décoder UTF8.

Lorsque des éléments sont récupérés à partir du cache, la page de codes système utilisée pour placer l’élément dans le cache doit correspondre à la page de codes système actuelle de l’utilisateur. Pour les applications s’exécutant sous IE6 et versions antérieures, si le décodage de la page de codes système échoue, WinINet tente de décoder UTF8.

Comme tous les autres aspects de l’API WinINet, cette fonction ne peut pas être appelée en toute sécurité à partir de DllMain ou des constructeurs et destructeurs d’objets globaux.

Remarque WinINet ne prend pas en charge les implémentations de serveur. En outre, il ne doit pas être utilisé à partir d’un service. Pour les implémentations de serveur ou les services, utilisez Microsoft Windows HTTP Services (WinHTTP).

Note

L’en-tête wininet.h définit CreateUrlCacheEntry comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
serveur minimum pris en charge	Windows 2000 Server [applications de bureau uniquement]
plateforme cible	Windows
d’en-tête	wininet.h
bibliothèque	Wininet.lib
DLL	Wininet.dll

Voir aussi

mise en cache

CommitUrlCacheEntry

fonctions WinINet

Partager via