CoInternetQueryInfo function

Artikel
07/13/2016

Retrieves information related to the specified URL.

Syntax

HRESULT CoInternetQueryInfo(
             LPCWSTR     pwzUrl,
             QUERYOPTION QueryOption,
             DWORD       dwQueryFlags,
             LPVOID      pvBuffer,
             DWORD       cbBuffer,
             DWORD       *pcbBuffer,
  _Reserved_ DWORD       dwReserved
);

Parameters

pwzUrl
A pointer to a string value that contains the URL.
QueryOption
A QUERYOPTION value that indicates the option to query.
dwQueryFlags
An unsigned long integer value that contains the query flags.
pvBuffer
A pointer to the buffer where the information will be stored.
cbBuffer
An unsigned long integer value that contains the size of the buffer.
pcbBuffer
A pointer to an unsigned long integer variable where the size of the requested information will be stored.
dwReserved
Reserved. Must be set to 0.

Return value

Returns one of the following values.

Return code	Description
S_OK	The operation completed successfully.
E_FAIL	The operation failed.
S_FALSE	The buffer is too small to store the information.
INET_E_QUERYOPTION_UNKNOWN	The option requested is unknown.

Remarks

The CoInternetQueryInfo function is a wrapper around the IInternetProtocolInfo::QueryInfo method. Pluggable protocol handlers should return S_FALSE and INET_E_QUERYOPTION_UNKNOWN error codes, as described above. For URLs not handled by a pluggable protocol handler, this function returns E_FAIL for both "buffer too small" and "option unknown" errors.

Requirements

Minimum supported client	Windows XP
Minimum supported server	Windows 2000 Server
Product	Internet Explorer 4.0
Header	Urlmon.h
Library	Urlmon.lib
DLL	Urlmon.dll

Dela via