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