Share via


IRTCClientProvisioning::CreateProfile (Windows Embedded CE 6.0)

1/6/2010

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.

Syntax

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 Value

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

Header rtccore.h, rtccore.idl
Library uuid.lib
Windows Embedded CE Windows CE .NET 4.0 and later

See Also

Reference

IRTCClientProvisioning
IRTCClientProvisioning::DisableProfile
IRTCClientProvisioning::EnableProfile
IRTCProfile