IMailSyncHandler::GetCapability
The GetCapability method is implemented by the transport to provide a way for Messaging to query whether the transport supports a certain capability.
Syntax
HRESULT GetCapability (
LPCWSTR pszName,
LPSPropValue pval
);
Parameters
- pszName
[in] A string value for a setting that the transport maintains. See Remarks for more information. - pval
[in] Supplies an SPropValue structure that the transport 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.
MAPI_E_NOT_FOUND
Indicates the capability setting is 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 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