RTCE_PROFILE events have an IRTCProfileEvent interface. This type of event is fired when in-band provisioning completes.
When the application's implementation of the IRTCEventNotification::Event method indicates an RTC_EVENT of type RTCE_PROFILE, the method's pEvent parameter is an IDispatch pointer for the IRTCProfileEvent interface.
Note You must call the IRTCClient::put_EventFilter method and set an event filter mask that includes the RTCE_PROFILE event to enable reception of info events. If you do not call IRTCClient::put_EventFilter, your application will not receive any events.
Methods in Vtable Order
The IRTCProfileEvent interface inherits the methods of the standard COM interfaces:
In addition, IRTCProfileEvent defines the following methods.
|get_Profile||Gets the IRTCProfile interface for the profile associated with this event. If the status code returned by get_StatusCode is not a success code, then this property will return RTC_E_NO_PROFILE.|
|get_Cookie||Returns the cookie associated with the IRTCClientProvisioning::GetProfile operation that has completed.|
|get_StatusCode||Returns the result code of the IRTCClientProvisioning::GetProfile operation that has completed.|
Redistributable: Requires Rtcdll.dll on Windows 2000, Windows XP, and Windows Server 2003.
Header: Declared in Rtccore.h.
Library: Included as a resource in Rtcdll.dll.
GUID: IID_IRTCProfileEvent is defined as D6D5AB3B-770E-43e8-800A-79B062395FCA.