Fonction GopherGetAttributeA (wininet.h)

Article
08/27/2023

[La fonction GopherGetAttribute peut être utilisée dans les systèmes d’exploitation spécifiés dans la section Configuration requise.]

Récupère les informations d’attribut spécifiques du serveur.

Syntaxe

BOOL GopherGetAttributeA(
  [in]  HINTERNET                   hConnect,
  [in]  LPCSTR                      lpszLocator,
  [in]  LPCSTR                      lpszAttributeName,
  [out] LPBYTE                      lpBuffer,
  [in]  DWORD                       dwBufferLength,
  [out] LPDWORD                     lpdwCharactersReturned,
  [in]  GOPHER_ATTRIBUTE_ENUMERATOR lpfnEnumerator,
  [in]  DWORD_PTR                   dwContext
);

Paramètres

[in] hConnect

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

[in] lpszLocator

Pointeur vers une chaîne terminée par null qui identifie l’élément sur le serveur Gopher sur lequel retourner des informations d’attribut.

[in] lpszAttributeName

Pointeur vers une chaîne délimitée par des espaces spécifiant les noms des attributs à retourner. Si lpszAttributeName a la valeur NULL, GopherGetAttribute retourne des informations sur tous les attributs.

[out] lpBuffer

Pointeur vers une mémoire tampon définie par l’application à partir de laquelle les informations d’attribut sont récupérées.

[in] dwBufferLength

Taille de la mémoire tampon lpBuffer , en TCHAR.

[out] lpdwCharactersReturned

Pointeur vers une variable qui contient le nombre de caractères lus dans la mémoire tampon lpBuffer .

[in] lpfnEnumerator

Pointeur vers une fonction de rappel GopherAttributeEnumerator qui énumère chaque attribut du localisateur. Ce paramètre est facultatif. S’il a la valeur NULL, toutes les informations d’attribut Gopher sont placées dans lpBuffer. Si lpfnEnumerator est spécifié, la fonction de rappel est appelée une fois pour chaque attribut de l’objet.

La fonction de rappel reçoit l’adresse d’une structure de GOPHER_ATTRIBUTE_TYPE unique à chaque appel. La fonction de rappel d’énumération permet à l’application d’éviter d’avoir à analyser les informations d’attribut Gopher.

[in] dwContext

Valeur définie par l’application qui associe cette opération à toutes les données d’application.

Valeur retournée

Retourne TRUE si la demande est satisfaite, ou FALSE dans le cas contraire. Pour obtenir des informations d’erreur étendues, appelez GetLastError ou InternetGetLastResponseInfo.

Remarques

En règle générale, les applications appellent cette fonction après avoir appelé GopherFindFirstFile ou InternetFindNextFile.

La taille du paramètre lpBuffer doit être égale ou supérieure à la valeur de MIN_GOPHER_ATTRIBUTE_LENGTH.

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.

Note 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).

Notes

L’en-tête wininet.h définit GopherGetAttribute en tant qu’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. La combinaison 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.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	wininet.h
Bibliothèque	Wininet.lib
DLL	Wininet.dll

Voir aussi

Fonctions WinINet