Export (0) Print
Expand All

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 codeDescription
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

 

 

Show:
© 2014 Microsoft