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.

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