Using XML Profiles

The XML profile is used to contain provisioning information, such as the types of service required, the session types that the client is provisioned for, the SIP server address and port, or the ITSP used. User information, such as name and password, and session information, such as session capabilities and service provider, are also included. The profile can be used in PC-PC sessions to supply the location of the outgoing SIP proxy, or in PC-phone sessions to specify the location of the gateway to the PSTN.

For a list of profile specifications for each session type, see the Profile Requirements section. The profile is created by the application, and the Profile object is created by the IRTCClientProvisioning::CreateProfile method. The IRTCProfile interface retrieves specific fields in the profile. If a specific profile is required for a session, it can be entered when the session is created with IRTCClient::CreateSession.

For more information on XML profiles, see Sample XML Profiles and XML Schema. For more information on client provisioning, see the Provisioning section.

Note   The profile can also be created by calling the RTC Client API version 1.2 method IRTCClientProvisioning::GetProfile. This method creates the profile object asynchronously. The application should wait for RTCE_PROFILE event with the event type RTCPFET_PROFILE_GET to get the profile object.