IRTCBuddy2::get_Profile
The get_Profile property returns the profile currently used by the buddy.
HRESULT get_Profile(IRTCProfile**ppProfile);
Parameters
- ppProfile
[out] Returns a pointer to the IRTCProfile interface. This call adds a reference to the interface, which the caller is responsible for releasing.
Return Values
RTC methods may return an RTC_E_ constant.
Value | Meaning |
---|---|
E_FAIL | The specified profile does not support the IRTCProfile interface. |
RTC_E_NOT_EXIST | There is no profile for this buddy. |
E_POINTER | The ppProfile parameter is not a valid pointer. |
Remarks
Obtaining the profile used by the buddy enables you to determine which server the profile is present on. A buddy's profile can exist on multiple servers, although only one may be currently active; this method will allow you to determine the location of the profile.
Requirements
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_IRTCBuddy2 is defined as 102F9588-23E7-40e3-954D-CD7A1D5C0361.