CoInternetQueryInfo function

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.

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