GopherGetAttributeA, fonction (wininet.h)

Article
11/20/2024

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

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érer une session Gopher retournée par InternetConnect.

[in] lpszLocator

Pointeur vers une chaîne null-terminated 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 un espace spécifiant les noms des attributs à retourner. Si lpszAttributeName est 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, dans TCHARs .

[out] lpdwCharactersReturned

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

[in] lpfnEnumerator

Pointeur vers un GopherAttributeEnumerator fonction de rappel qui énumère chaque attribut du localisateur. Ce paramètre est facultatif. S’il s’agit 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 avec 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 de retour

Retourne TRUE si la requête est satisfaite, ou FALSE sinon. 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.

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