IMessageFormHostEx::GetGlobalSetting
The GetGlobalSetting method gets the value of the global setting from the e-mail application.
Note This host method is the same one provided as part of IMailSyncCallBack:: GetGlobalSetting.
Syntax
HRESULT GetGlobalSetting (
LPCWSTR pszSetting,
LPSPropValue pval
);
Parameters
- pszSetting
[in] Reference to settings (string values defined in cemapi.h) maintained by the e-mail application. - pval
[out] Reference to an SPropValue structure that the e-mail application sets with the value.
Return Values
This method returns the standard values E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED, and E_FAIL, as well as the following:
- S_OK
Indicates success.
Remarks
If the value returned by the e-mail application is a string, do not use the IMailSyncCallback::FreeMem method to free the memory. The following table lists the set of possible global property string values.
| Constant WCHAR setting | String value |
|---|---|
| kszCapSaveSent[] | "SaveSent" |
| kszCapSMSUnicode[] | "SMSUnicode" |
| kszCapIncludeOriginal[] | "IncludeOriginal" |
| kszCapIndentBody[] | "IndentBody" |
| kszCapAddLeading[] | "AddLeading" |
| kszCapLeadChar[] | "LeadChar" |
| kszCapSMSRequestStatus[] | "SMSRequestStatus" |
| kszCapSMTPAllowAuthLogin[] | "SMTPAllowAuthLogin" |
| kszCapDeleteAction[] | "DeleteAction" |
| kszCapReturnAddress[] | "ReturnAddress" |
Requirements
Pocket PC: Windows Mobile 2003 and later
Smartphone: Windows Mobile 2003 and later
OS Versions: Windows CE .NET 4.2 and later
Header: cemapi.h
Library: cemapi.lib
See Also
IMailSyncCallback::FreeMem | IMessageFormHostEx | IMessageFormHostEx::SetGlobalSetting | Messaging
Send Feedback on this topic to the authors