IRTCProfile2::get_Realm
The get_Realm method gets the realm value for the profile.
HRESULT get_Realm(BSTR*pbstrRealm);
Parameters
- pbstrRealm
[out] String value containing the name of the realm set on this profile.
Return Values
RTC methods may return an RTC_E_ constant.
| Value | Meaning |
|---|---|
| RTC_E_INVALID_PROFILE | The profile is not valid. |
| RTC_E_NOT_EXIST | The realm is not present in the profile. |
| E_OUTOFMEMORY | Insufficient memory to perform this operation. |
| E_POINTER | The pbstrRealm parameter is not a valid pointer. |
Remarks
If no realm value was ever set (using put_Realm), the profile object will use the realm value provided in the first authentication challenge. If the challenge does not have a realm value, this method will return RTC_E_NOT_EXIST.
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_IRTCProfile2 is defined as 4B81F84E-BDC7-4184-9154-3CB2DD7917FB.