IRTCBuddy2::Profile
Other versions of this page are also available for the following:
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
8/28/2008
Note
This method is unsupported in Windows Embedded CE 6.0.
This method gets the profile currently used by the buddy.
Syntax
HRESULT get_Profile(
IRTCProfile2** ppProfile
);
Parameters
- ppProfile
[out] Pointer to the IRTCProfile2 interface. This method adds a reference to the interface, which the caller is responsible for releasing.
Return Value
This method can return an RTC_E_ constant. The following table shows additional possible return values.
| Value | Meaning |
|---|---|
E_FAIL |
The specified profile does not support the IRTCProfile2 interface. |
E_POINTER |
The ppProfile parameter is not a valid pointer. |
Remarks
Obtaining the profile using the buddy enables the developer to determine the server on which the profile is present. A buddy's profile can exist on multiple servers, although only one may be currently active. The IRTCBuddy2::Profile method determines the server location of the profile.
Requirements
| Header | rtccore.h, rtccore.idl |
| Library | uuid.lib |
| Windows Embedded CE | Windows CE .NET 4.2 and later |