IMailSyncHandler::SetCapability
The SetCapability method is used by Messaging to set the capabilities that are supported by the transport.
Syntax
HRESULT SetCapability (
LPCWSTR pszName,
LPSPropValue pval
);
Parameters
- pszName
[in] String value for a setting that the transport maintains. See Remarks for more information. - pval
[in] Supplies an instance of an SPropValue structure that contains the value to set for the capability. There is no need to free this buffer or hold onto it. It is valid only for the duration of the call.
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.
MAPI_E_NOT_FOUND
Indicates capability setting not maintained by the transport.
Remarks
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" |
The following table lists the set of possible global property string values that have associated Boolean default values, which override the default in IMailSyncHandler::GetCapability.
| Constant WCHAR setting | String value | Default |
|---|---|---|
| kszCapFolders[] | "Folders" | TRUE |
| kszCapFolderNotifications[] | "FolderNotifications" | FALSE |
| kszCapClearAll[] | "ClearAll" | TRUE |
| kszCapEmptyDeleteItem[] | "EmptyDeleteItem" | TRUE |
| kszCapEditProperties[] | "EditProperties" | TRUE |
| kszCapFolderOptions[] | "EmptyFolderOptions" | TRUE |
| kszCapMgmtFolder[] | "MgmtFolder" | TRUE |
| kszCapSync[] | "Sync" | TRUE |
| kszCapSyncOnDockEvent[] | "SyncOnDockEvent" | TRUE |
| kszCapConnect[] | "Connect" | TRUE |
| kszCapRequireRadio[] | "RequireRadio" | FALSE |
| kszCapMarkAttachments[] | "MarkAttachments" | FALSE |
| kszCapReplyAll[] | "ReplyAll" | TRUE |
| kszCapAlwaysIncludeOriginal[] | "AlwaysIncludeOriginal" | FALSE |
| kszCapCompose[] | "Compose" | TRUE |
| kszCapOfflineStatus[] | "OfflineStatus" | TRUE |
| kszCapCallSender[] | "CallSender" | FALSE |
| kszCapLanguage[] | "Language" | TRUE |
| kszCapAttachments[] | "Attachments" | TRUE |
| kszCapFolderManagementAllowCreate[] | "FolderManagementAllowCreate" | TRUE |
| kszCapFolderManagementAllowRename[] | "FolderManagementAllowRename" | TRUE |
| kszCapFolderManagementAllowDelete[] | "FolderManagementAllowDelete" | TRUE |
Requirements
Pocket PC: Pocket PC 2002 and later
Smartphone: Smartphone 2002 and later
OS Versions: Windows CE 3.0 and later
Header: cemapi.h
Library: cemapi.lib
See Also
Send Feedback on this topic to the authors