IMailSyncHandler::GetCapability

Article
08/28/2006

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

Smartphone: Windows Mobile 2002 and later
OS Versions: Windows CE 3.0 and later
Header: cemapi.h
Library: cemapi.lib

Share via