PersistentName Property of the IFPCPersist Interface

Article
08/13/2010

The PersistentName property gets the persistent name of the object. The persistent name of an object is a name that is unique for the object at the respective level of the COM object hierarchy. For predefined objects, the persistent name is a globally unique identifier (GUID) that does not vary in different localized versions of Forefront TMG.

C++

HRESULT get_PersistentName(
    BSTR* pbstrPersistentName
);

Parameters

pbstrPersistentName
Pointer to a BSTR that is set on return to a string value specifying the persistent name of the object.

Return Value

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

Visual Basic

Property PersistentName As String

Property Value

String that specifies the persistent name of the object.

Remarks

This property is read-only.

The persistent names of all of the predefined objects that are installed with Forefront TMG are listed in FpcObjectsGuids.h.

The persistent names of all of the predefined objects that are installed with Forefront TMG are listed in FpcObjectsGuids.vbs and FpcObjectsGuids.js.

Requirements

Client	Requires Windows 7 or Windows Vista.
Server	Requires Windows Server 2008 R2 or Windows Server 2008 x64 Edition with SP2.
Version	Requires Forefront Threat Management Gateway (TMG) 2010.
IDL	Declared in Msfpccom.idl.
DLL	Requires Msfpccom.dll.