IFPCURLSet::Add method

Article
08/27/2012

Applies to: desktop apps only

The Add method adds a new Uniform Resource Locator (URL) to the URL set.

Syntax

HRESULT Add(
  [in]  BSTR Name
);

FPCURLSet.Add( _
  ByVal Name As String _
)

Parameters

Name [in]

C++ Required. BSTR that specifies the new URL.

VB Required. String that specifies the new URL.

Return value

C++

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

VB

This method has no return values. If the call is unsuccessful, an error is raised that can be intercepted by using an error handler.

Remarks

The URL specified in the Name parameter may include a host name and a path. Wildcard characters are allowed. However, URLs containing a question mark (?) are ignored. A protocol (HTTP, HTTPS, or FTP) and a port number may be included, but these are ignored.

Hosts may be specified in any of the following formats:

FQDN (for example, www.northwindtraders.com).
DNS suffix (for example, *.net).
IP Address.
Wildcard character (*).

Paths may be specified in any of the following formats:

Full path (for example, default.htm).
Prefix (for example, /pictures/travel/* or /*).

Requirements

Minimum supported client	Windows Vista
Minimum supported server	Windows Server 2008 R2, Windows Server 2008 with SP2 (64-bit only)
Version	Forefront Threat Management Gateway (TMG) 2010
IDL	Msfpccom.idl
DLL	Msfpccom.dll