CHttpFile::QueryInfo

Článek
03/04/2013

Volání funkce tohoto člena vrátit odpověď nebo požádat záhlaví požadavku protokolu HTTP.

BOOL QueryInfo(
   DWORD dwInfoLevel,
   LPVOID lpvBuffer,
   LPDWORD lpdwBufferLength,
   LPDWORD lpdwIndex = NULL 
) const;
BOOL QueryInfo(
   DWORD dwInfoLevel,
   CString& str,
   LPDWORD dwIndex = NULL 
) const;
BOOL QueryInfo(
   DWORD dwInfoLevel,
   SYSTEMTIME* pSysTime,
   LPDWORD dwIndex = NULL 
) const;

Parametry

dwInfoLevel
Kombinace atributů dotazu a následující příznaky, které určují typ požadované informace:
- HTTP_QUERY_CUSTOM vyhledá název hlavičky a vrátí tuto hodnotu v lpvBuffer na výstupu.HTTP_QUERY_CUSTOM vyvolá nepravdivých, pokud není nalezen v záhlaví.
- HTTP_QUERY_FLAG_REQUEST_HEADERS obvykle aplikace dotazuje hlavičky odpovědi, ale také dotaz záhlaví požadavku pomocí příznaku této aplikace.
- HTTP_QUERY_FLAG_SYSTEMTIME těchto záhlaví, jehož hodnota je datum a čas řetězec, například "Poslední změny-času," vrátí tento příznak hodnotu hlavičky jako standardní Win32 SYSTEMTIME struktury, která nevyžaduje použití analyzovat data.Pokud použijete tento příznak, můžete použít SYSTEMTIME funkce přepsat.
- HTTP_QUERY_FLAG_NUMBER u těchto záhlaví, jehož hodnota je číslo, například kód stavu tento příznak vrací data jako 32bitové číslo.
Najdete poznámky v části Seznam možných hodnot.
lpvBuffer
Ukazatel do vyrovnávací paměti, který obdrží informace.
lpdwBufferLength
V položce to ukazuje hodnotu obsahující délka vyrovnávací paměti dat v počtu znaků nebo bajtů.Najdete poznámky části Další informace o tomto parametru.
lpdwIndex
Ukazatel myši na záhlaví z nuly vycházející index.Může být NULL.Použijte tento výčet více záhlaví se stejným názvem.Na vstupu lpdwIndex označuje index zadané záhlaví vrátit.Na výstupu lpdwIndex označuje index další záhlaví.Pokud nelze najít další index, ERROR_HTTP_HEADER_NOT_FOUND je vrácena.
str
Odkaz na CString objektu vrácené informace obdrží.
dwIndex
Hodnotu indexu.Viz téma lpdwIndex.
pSysTime
Ukazatel na Win32 SYSTEMTIME struktury.

Vrácená hodnota

Nenulová hodnota, pokud je úspěšná. jinak 0.Pokud selže volání funkce Win32 GetLastError může být volána zjistit příčinu chyby.

Poznámky

Pomocí této funkce člena pouze po úspěšné volání Odesilani nebo CHttpFile úspěšně vytvořen objekt OpenURL.

Můžete načíst následující typy dat z QueryInfo :

řetězce (výchozí)
SYSTEMTIME(pro "dat:" "Expires:" etc, záhlaví)
DWORD(pro STATUS_CODE, CONTENT_LENGTHatd.)

Pokud řetězec je zapsán do vyrovnávací paměti a členské funkce úspěšná, lpdwBufferLength obsahuje délku řetězce znaků minus 1 pro ukončující NULL znaků.

Možné dwInfoLevel hodnoty zahrnují: