Notice: This website is an unofficial Microsoft Knowledge Base (hereinafter KB) archive and is intended to provide a reliable access to deleted content from Microsoft KB. All KB articles are owned by Microsoft Corporation. Read full disclaimer for more details.

How To Get WinInet Information from a URL Moniker Binding


View products that this article applies to.

This article was previously published under Q176787

↑ Back to the top


Summary

Programs that use URL Monikers to download data but need to obtain extra low-level WinInet information about the download can use the IWinInetHttpInfo and IWinInetInfo interfaces.

The IWinInetHttpInfo interface implemented by the binding object can be used to make the equivalent of HttpQueryInfo calls. In the same fashion, IWinInetInfo can be used to make the equivalent of InternetQueryOption calls.

↑ Back to the top


More information

The user of a URL Moniker receives a reference to the IBinding interface of the binding object in the IBindStatusCallback::OnStartBinding interface. When binding to an HTTP server, the binding object supports the IWinInetHttpInfo interface for obtaining HTTP-specific information, such as HTTP headers. The binding object also supports the IWinInetInfo interface for obtaining Internet options such as the name of the file downloaded by a URL moniker binding. Both interfaces support the QueryInfo method. QueryInfo basically forwards the call to the standard WinInet functions HttpQueryInfo and InternetQueryOption, respectively.

Here is a sample snippet of code from an IBindStatusCallback implementation that uses IWininetHttpInfo to retrieve the raw headers sent by the HTTP server. It then uses IWininetInfo to query for the name of the local data file returned by the download:
   // required includes:
   #include <urlmon.h>
   #include <wininet.h>

   STDMETHOD(OnStopBinding)(HRESULT hresult, LPCWSTR szError)
   {
      // m_spBinding is the IBinding interface passed in OnStartBinding

      if (!FAILED(hresult))
      {
         IWinInetHttpInfo* pInfo;
         char buff[1024];
         DWORD dwBuffSize = 1024;
         HRESULT hr = m_spBinding->QueryInterface(IID_IWinInetHttpInfo,
                                                  (void**)&pInfo);
         if (!FAILED(hr))
         {
            BOOL bResult = pInfo->QueryInfo(HTTP_QUERY_RAW_HEADERS,
                                            buff, &dwBuffSize, 0, NULL);
         }
         pInfo->Release();
      }

      if (!FAILED(hresult))
      {
         IWinInetInfo* pInfo;
         char buff[1024];
         DWORD dwBuffSize = 1024;
         HRESULT hr = m_spBinding->QueryInterface(IID_IWinInetInfo,
                                                  (void**)&pInfo);
         if (!FAILED(hr))
         {
            BOOL bResult = pInfo
            ->QueryOption(INTERNET_OPTION_DATAFILE_NAME,
                                             buff, &dwBuffSize);
         }
         pInfo->Release();
      }

   // ...
   return S_OK;
   }
				
For complete information on the parameters available to IWinInetHttpInfo::QueryInfo and IWinInetInfo::QueryOption, review the Internet Client SDK documentation for the WinInet functions HttpQueryInfo and InternetQueryOption, respectively.

↑ Back to the top


References

Internet Client SDK: Internet Tools & Technologies; Monikers, URLs, Security Zones, and Pluggable Protocols

Internet Client SDK: Internet Tools & Technologies; WinInet API

↑ Back to the top


Keywords: KB176787, kbhowto, kbcode

↑ Back to the top

Article Info
Article ID : 176787
Revision : 3
Created on : 7/1/2004
Published on : 7/1/2004
Exists online : False
Views : 417