Share via

IRTCClientProvisioning::CreateProfile

  • Article

The CreateProfile method creates a Profile object from an XML string that conforms to the provisioning schema. Profiles contain information about network resources and accounts that may be used to place calls or handle presence.

HRESULT CreateProfile(BSTRbstrProfileXML,
IRTCProfile**ppProfile);

Parameters

  • bstrProfileXML
    [in] String containing the XML profile.
  • ppProfile
    [out] Pointer to a pointer to the returned IRTCProfile interface pointer.

Return Values

RTC methods may return an RTC_E_ constant. The RTC_E_PROFILE_ constants can all be returned from this method.

Value Meaning
RTC_E_CLIENT_NOT_INITIALIZED The client is not initialized.
RTC_E_UDP_NOT_SUPPORTED The application attempted to specify an authentication method that is not supported under the UDP transport. If any server listed in the profile specifies the UDP transport, Digest is the only authentication method allowed. All other authentication methods will be rejected.

Remarks

The TLS transport is required when Basic is specified as the authentication method in the profile. The Kerberos and NTLM authentication methods are supported over the TCP or TLS transport method. If the UDP transport is specified for any server listed in the profile, and Basic, Kerberos, USE_LOGON_CRED, or NTLM is requested, the profile will be rejected.

For information on server registration or automatic profile selection, see IRTCClientProvisioning::EnableProfile and IRTCClientProvisioning::DisableProfile.

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_IRTCClientProvisioning is defined as B9F5CF06-65B9-4a80-A0E6-73CAE3EF3822.

See Also

IRTCClientProvisioning, IRTCProfile, Create and Enable a Profile, IRTCClientProvisioning::EnableProfile, IRTCClientProvisioning::DisableProfile, Roaming