IRTCClientProvisioning::CreateProfile (Windows CE 5.0)

Send Feedback

This method creates a Profile object from an XML string that conforms to the provisioning schema.

Profiles contain information about network resources and accounts that can be used to place calls or handle presence.

HRESULT CreateProfile(BSTR bstrProfileXML,IRTCProfile** ppProfile);

Parameters

  • bstrProfileXML
    [in] XML profile string.

  • ppProfile
    [out] Pointer to the IRTCProfile interface.

    This method adds a reference to the Profile object, which the caller is responsible for releasing.

Return Values

This method can return an RTC_E_ constant.

The following table shows additional information about a specific return value.

Value Meaning
RTC_E_UDP_NOT_SUPPORTED The application attempted to specify an authentication method that is not supported under the UDP transport.

If a server listed in the profile specifies the UDP transport, Digest is the only authentication method allowed. All other authentication methods are rejected.

Remarks

The TLS transport is required when Basic authentication is specified 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 is rejected.

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

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: Rtccore.h, Rtccore.idl.
Link Library: Uuid.lib.

See Also

IRTCClientProvisioning | IRTCClientProvisioning::DisableProfile | IRTCClientProvisioning::EnableProfile | IRTCProfile

Send Feedback on this topic to the authors

Feedback FAQs

© 2006 Microsoft Corporation. All rights reserved.