GopherOpenFileW, fonction (wininet.h)

Article
11/20/2024

[La fonction GopherOpenFile est disponible pour une utilisation dans les systèmes d’exploitation spécifiés dans la section Exigences.]

Commence à lire un fichier de données Gopher à partir d’un serveur Gopher.

Syntaxe

HINTERNET GopherOpenFileW(
  [in] HINTERNET hConnect,
  [in] LPCWSTR   lpszLocator,
  [in] LPCWSTR   lpszView,
  [in] DWORD     dwFlags,
  [in] DWORD_PTR dwContext
);

Paramètres

[in] hConnect

Gérer une session Gopher retournée par InternetConnect.

[in] lpszLocator

Pointeur vers une chaîne null-terminated qui spécifie le fichier à ouvrir. En règle générale, ce localisateur est retourné à partir d’un appel à GopherFindFirstFile ou InternetFindNextFile. Étant donné que le protocole Gopher n’a pas de concept d’annuaire actif, le localisateur est toujours complet.

[in] lpszView

Pointeur vers une chaîne null-terminated qui décrit la vue à ouvrir si plusieurs vues du fichier existent sur le serveur. Si lpszView est NULL, la fonction utilise la vue de fichier par défaut.

[in] dwFlags

Conditions dans lesquelles des transferts ultérieurs se produisent. Ce paramètre peut être l’une des valeurs suivantes.

Valeur	Signification
INTERNET_FLAG_HYPERLINK	Force un rechargement s’il n’y a pas eu d’heure d’expiration et qu’aucune heure LastModified n’a été retournée par le serveur lorsque vous déterminez s’il faut recharger l’élément à partir du réseau.
INTERNET_FLAG_NEED_FILE	Provoque la création d’un fichier temporaire si le fichier ne peut pas être mis en cache.
INTERNET_FLAG_NO_CACHE_WRITE	N’ajoute pas l’entité retournée au cache.
INTERNET_FLAG_RELOAD	Force le téléchargement du fichier, de l’objet ou de la liste de répertoires demandés à partir du serveur d’origine, et non à partir du cache.
INTERNET_FLAG_RESYNCHRONIZE	Recharge les ressources HTTP si la ressource a été modifiée depuis la dernière fois qu’elle a été téléchargée. Toutes les ressources FTP et Gopher sont rechargées.

[in] dwContext

Pointeur vers une variable qui contient une valeur définie par l’application qui associe cette opération à toutes les données d’application.

Valeur de retour

Retourne un handle en cas de réussite, ou NULL si le fichier ne peut pas être ouvert. Pour récupérer des informations d’erreur étendues, appelez GetLastError ou InternetGetLastResponseInfo.

Remarques

GopherOpenFile ouvre un fichier sur un serveur Gopher. Étant donné qu’un fichier ne peut pas réellement être ouvert ou verrouillé sur un serveur, cette fonction associe simplement les informations d’emplacement à un handle qu’une application peut utiliser pour des opérations basées sur des fichiers telles que InternetReadFile ou GopherGetAttribute.

Une fois l’application appelante terminée à l’aide du handle HINTERNET retourné par GopherOpenFile, il doit être fermé à l’aide de la fonction InternetCloseHandle.

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

fonctions WinINet

Partager via