Share via

IRTCClientProvisioning::DisableProfile

  • Article

The DisableProfile method disables a profile that was previously enabled with IRTCClientProvisioning::EnableProfile. If the profile was registered, unregistration will occur.

HRESULT DisableProfile(IRTCProfile*pProfile);

Parameters

  • pProfile
    [in] The profile that is disabled.

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.

Remarks

Disabled profiles will no longer show up in the profile list returned by IRTCClientProvisioning::EnumerateProfiles and IRTCClientProvisioning::get_Profiles. Also, disabled profiles are not available to be selected by IRTCClient::CreateSession and IRTCClientPresence::AddBuddy.

This function may send data over the wire in unencrypted form; therefore, someone eavesdropping on the network may be able to read the data. The security risk of sending the data in clear text should be considered before using this method in an unencrypted session. An RTC session can be encrypted by specifying TLS in the profile used for the session.

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, Deregister and Disable a Profile, IRTCClientProvisioning::EnableProfile, IRTCClientProvisioning::CreateProfile, Roaming