IRTCProfile
The IRTCProfile interface is the main interface for the Profile object. This object is created by the IRTCClientProvisioning::CreateProfile method. This interface retrieves information from the provisioning profile.
For more information on the Profile object, see the Create and Enable a Profile code example.
Methods in Vtable Order
The IRTCProfile interface inherits the methods of the standard COM interface IUnknown.
In addition, IRTCProfile defines the following methods.
| Method | Description |
|---|---|
| get_Key | Returns the key that uniquely identifies the profile. |
| get_Name | Returns the name of the profile. |
| get_XML | Returns the XML string used to create the profile. |
| get_ProviderName | Returns the name of the provider for the profile. |
| get_ProviderURI | Returns the provider URI for the profile. |
| get_ProviderData | Returns the XML string from the profile that contains the provider's private data tag. |
| get_ClientName | Returns the name of the Client for the specified profile. |
| get_ClientBanner | Returns a flag that specifies if the Client should display the banner for the profile. |
| get_ClientMinVer | Returns the minimum version of the Client for this profile. If the Client is lower than this version, it must attempt to upgrade by visiting the URI returned by get_ClientUpdateURI. |
| get_ClientCurVer | Returns the current version of the Client for this profile. If the Client is lower than this version, it may upgrade by visiting the URI returned by get_ClientUpdateURI. |
| get_ClientUpdateURI | Returns the URI where updates of the Client are available for the profile. |
| get_ClientData | Returns the XML string from the profile that contains the Client's private data tag. |
| get_UserURI | Returns the user URI associated with the profile. |
| get_UserName | Returns the user name associated with the profile. |
| get_UserAccount | Returns the user account associated with the profile. |
| SetCredentials | Overrides the profile credentials. |
| get_SessionCapabilities | Returns the types of sessions supported by the provider for the profile. |
| get_State | Returns the current state of registration for the profile. |
Requirements
Client: Requires Windows XP.
Server: Requires Windows Server 2003.
Redistributable: Requires Rtcdll.dll on Windows 2000, and Windows Me/98.
Header: Declared in Rtccore.h.
Library: Included as a resource in Rtcdll.dll.
GUID: IID_IRTCProfile is defined as d07eca9e-4062-4dd4-9e7d-722a49ba7303.