Querying TLD Policy Data

This document explains how to retrieve the characters from the Top-Level Domain Blacklists and Whitelists.

1. Create a connection with the InetURIList server.

   
   RInetUriList uriServer;
   uriServer.OpenL();
   CleanupClosePushL(uriServer);
   

2. Build a TPolicyQueryArgs object. The constructor takes an URI as its first parameter, which defines which TLD the request is made on.
   1. 
      To request a character set, pass the list type (InetUriList::EWhiteList or InetUriList::EBlackList) as the second parameter, and the InetUriList::EPolicyCharSet request type as the third parameter.

      
      // The TLD is "COM"
      _LIT8(KUri, "http://www.nokia.com");
      
      // the query requests the white list character set
      TPolicyQueryArgs tldArgs(KUri, InetUriList::EWhiteList, InetUriList::EPolicyCharSet);
      

   2. 
      To check whether an URI is unsafe, only pass the InetUriList::EPolicyListType request type as the second parameter.

      
      // The TLD is "COM"
      _LIT8(KUri, "http://www.nokia.com");
      
      // the query requests to check the URI
      TPolicyQueryArgs tldArgs(KUri, InetUriList::EPolicyListType);
      

3. Create a TQueryResults object to store the result.

   TQueryResults tldResult;

4. Call the RInetUriList::QueryTldInfoL() method with your query and result structures.

   RInetUriList::QueryTldInfoL(tldArgs, tldResult);
   
   // retrieve the characters
   HBufC8* policyData(NULL);
   policydata = tldResult.CharSetL();

5. Close the connection with the InetURIList server.

   CleanupStack::PopAndDestroy(&uriServer);

// Open the connection
RInetUriList uriServer;
uriServer.OpenL();
CleanupClosePushL(uriServer);

// The TLD is "COM"
_LIT8(KUri, "http://www.nokia.com");

// Build a query requesting a character set
TPolicyQueryArgs tldArgs(KUri, InetUriList::EPolicyCharSet);

// Create an object for the results
TQueryResults tldResult;

// Make the query
RInetUriList::QueryTldInfoL(tldArgs, tldResult);

// retrieve the characters
HBufC8* policyData(NULL);
policydata = tldResult.CharSetL();

// [...] 
// process the policy data

// Close the connection
CleanupStack::PopAndDestroy(&uriServer);