CHttpFile::QueryInfo

BOOL QueryInfo (DWORD dwInfoLevel, LPVOID lpvBuffer, LPDWORD lpdwBufferLength, LPDWORD lpdwIndex = NULL) const ;

BOOL QueryInfo (DWORD dwInfoLevelCString& ;strLPDWORDdwIndex= NULL) const ;

BOOL QueryInfo (DWORD dwInfoLevel, SYSTEMTIME * pSysTime, LPDWORD dwIndex = NULL) const ;

Valeur de retour

Différent de zéro en cas de succès ; sinon 0. Si l'appel échoue, la fonction Win32 GetLastError peut être appelée pour déterminer la cause de l'erreur.

Paramètres

dwInfoLevel

Une combinaison de l'attribut de requête et les indicateurs suivants qui spécifient le type de renseignements demandés:

• HTTP_QUERY_CUSTOM  ;  Trouve le nom d'en-tête et retourne cette valeur dans lpvBuffer sur la production. HTTP_QUERY_CUSTOM lève une assertion si l'en-tête n'est pas trouvé.
  
  
• HTTP_QUERY_FLAG_REQUEST_HEADERS  ;  Généralement, l'application interroge les en-têtes de réponse, mais une application peut également interroger d'en-têtes de demande à l'aide de cet indicateur.
  
  
• HTTP_QUERY_FLAG_SYSTEMTIME  ;  Pour ces en-têtes dont la valeur est une chaîne de date/heure, tels que « Dernière modification-temps, » ce drapeau renvoie la valeur d'en-tête comme un Win32 standard structure SYSTEMTIME qui ne nécessite pas l'application pour analyser les données. Si vous utilisez cet indicateur, vous pouvez utiliser la substitution SYSTEMTIME de la fonction.
  
  
• HTTP_QUERY_FLAG_&NUMBERnbsp ;  Pour ces en-têtes dont la valeur est un nombre, comme le code d'État, cet indicateur retourne les données comme un nombre 32 bits.

  Consultez la section remarques pour obtenir une liste des valeurs possibles.

lpvBuffer

Un pointeur vers la mémoire tampon qui reçoit les informations.

lpdwBufferLength

À l'entrée, cela indique une valeur contenant la longueur de la mémoire tampon de données, en nombre de caractères ou d'octets. Consultez la section remarques pour plus d'informations sur ce paramètre.

lpdwIndex

Pointeur vers un index de base zéro d'en-tête. Peut être NULL. Utilisez ce drapeau pour énumérer plusieurs en-têtes avec le même nom. À l'entrée, lpdwIndex indique l'index de l'en-tête spécifié à retourner. Sur la production, lpdwIndex indique l'index de l'en-tête suivant. Si Impossible de trouver l'indice suivant, ERROR_HTTP_HEADER_NOT_FOUND est retourné.

str

Une référence à l'objet CString recevant les informations renvoyées.

dwIndex

Une valeur d'index. Voir lpdwIndex.

pSysTime

Un pointeur vers un Win32 structure SYSTEMTIME.

Remarques

Appelez cette fonction membre pour retourner la réponse ou de demander des en-têtes dans une demande HTTP. Utilisez cette fonction membre seulement après un appel réussi à SendRequest ou sur un objet CHttpFile créé par OpenURL.

Vous pouvez récupérer les types de données suivants de QueryInfo:

• chaînes (par défaut)
  
  
• SYSTEMTIME (pour « données: « "Expires:" etc., en-têtes)
  
  
• DWORD (pour STATUS_CODE, CONTENT_LENGTH, etc.).

Lorsqu'une chaîne est écrite dans la mémoire tampon, et succède à la fonction membre, lpdwBufferLength contient la longueur de la chaîne de caractères moins 1 pour le caractère NULL de fin.

Les valeurs possibles de dwInfoLevel comprennent:

• HTTP_QUERY_MIME_VERSION
  
  
• HTTP_QUERY_CONTENT_TYPE
  
  
• HTTP_QUERY_CONTENT_TRANSFER_ENCODING
  
  
• HTTP_QUERY_CONTENT_ID
  
  
• HTTP_QUERY_CONTENT_DESCRIPTION
  
  
• HTTP_QUERY_CONTENT_LENGTH
  
  
• HTTP_QUERY_ALLOWED_METHODS
  
  
• HTTP_QUERY_PUBLIC_METHODS
  
  
• HTTP_QUERY_DATE
  
  
• HTTP_QUERY_EXPIRES
  
  
• HTTP_QUERY_LAST_MODIFIED
  
  
• HTTP_QUERY_MESSAGE_ID
  
  
• HTTP_QUERY_URI
  
  
• HTTP_QUERY_DERIVED_FROM
  
  
• HTTP_QUERY_LANGUAGE
  
  
• HTTP_QUERY_COST
  
  
• HTTP_QUERY_WWW_LINK
  
  
• HTTP_QUERY_PRAGMA
  
  
• HTTP_QUERY_VERSION
  
  
• HTTP_QUERY_STATUS_CODE
  
  
• HTTP_QUERY_STATUS_TEXT
  
  
• HTTP_QUERY_RAW_HEADERS
  
  
• HTTP_QUERY_RAW_HEADERS_CRLF

CHttpFile aperçu |  ; Membres de la classe | Graphique de la hiérarchie

Voir aussi  ;CInternetFile, CHttpConnection::OpenRequest, CFtpConnection, CGopherConnection, CInternetConnection