QueryUrlCategory Method of the IFPCUrlFilteringSettings Interface

The QueryUrlCategory method queries the URL category database and the FPCUrlToCategoryMappings collection to determine the URL category of the specified URL.

[C++]

HRESULT QueryUrlCategory(
  [in]   BSTR bstrUrl,
  [out]  FpcUrlCategoryT* pCategoryID,
  [out]  FpcUrlCategorizationReason* pReason
);

bstrUrl: Required. BSTR that specifies the URL.
pCategoryID: Pointer to a value that is set on return to the identifier of the category.
pReason: Pointer to a variable that on return points to a FpcUrlCategorizationReason enumerated type.

This method returns S_OK if the call is successful; otherwise, it returns an error code.

[Visual Basic]

Function QueryUrlCategory( _
  ByVal bstrUrl As String, _
  ByRef pCategoryID As FpcUrlCategoryT, _
  ByRef pReason As FpcUrlCategorizationReason _
)

bstrUrl: Required. String that specifies the URL.
pCategoryID: Reference to a variable that is set on return to the identifier of the category.
pReason: Reference to a variable that is set on return to a FpcUrlCategorizationReason enumerated type.

If the call is unsuccessful, an error is raised that can be intercepted by using an error handler.

Client	Requires Windows Vista or Windows XP.
Server	Requires Windows Server 2008.
Version	Requires Forefront Threat Management Gateway (TMG).
IDL	Declared in Msfpccom.idl.
DLL	Requires Msfpccom.dll.