Microsoft KB Archive/177623

= PRB: Rule that Applies to All Messages Cannot Be Created =

Article ID: 177623

Article Last Modified on 3/4/2004

-

APPLIES TO


 * Microsoft Exchange Development Kit 5.5

-



This article was previously published under Q177623



SYMPTOMS
A rule that applies to all the messages that come into an Inbox cannot be created using any of the helper functions such as HRInsert, because this type of rule requires that the restriction structure be empty.

This is a problem because the HrStringToRestriction function [used to create a restriction to pass to HRInsert and other similar functions] fails with MAPI_E_INVALID_PARAMETER when called with a NULL for the restriction string.



CAUSE
The call returns MAPI_E_INVALID_PARAMETER because HrStringToRestriction expects a string, not a NULL.



RESOLUTION
The following code allows you to programmatically create a rule that applies to all messages. The code provided is not complete. It assumes that you already have a handle to a MAPI session, a pointer to the message store, a pointer to the folder the rule is to be applied to, and that you will release the appropriate structures before exiting the program. hr = AllMessageRule(m_lpExchTbl,              lpFolder,0,lStateFlags,               lpRes,lpActs,"MSFT:TDX Rules",0,"");

if (FAILED(hr)) {     MessageBox(NULL,"Insert Failed",NULL,MB_OK); goto cleanup; }

HRESULT AllMessageRule(IN LPEXCHANGEMODIFYTABLE m_lpExchTbl,     IN LPMAPIFOLDER   lpFolder,      IN ULONG          ulSequence,      IN ULONG          ulState,      IN LPSRestriction lpRestriction,      IN LPACTIONS      lpActions,      IN LPSTR          lpszProvider,      IN ULONG          ulLevel,      IN LPSTR          lpszName) {   HRESULT              hr         = S_OK; SizedROWLIST(1, RowList) = {0}; LPROWENTRY     lpRowEntry      = NULL; LPROWLIST      lpRowList       = (LPROWLIST)&RowList; SPropValue     rgPropVals[9]   = {0};

rgPropVals[0].ulPropTag    =   PR_RULE_SEQUENCE; rgPropVals[0].Value.ul     =   ulSequence;

rgPropVals[1].ulPropTag    =   PR_RULE_STATE; rgPropVals[1].Value.ul     =   ulState;

rgPropVals[2].ulPropTag    =   PR_RULE_CONDITION; rgPropVals[2].Value.ul     =   (ULONG)lpRestriction;

rgPropVals[3].ulPropTag    =   PR_RULE_ACTIONS; rgPropVals[3].Value.ul     =   (ULONG)lpActions;

rgPropVals[4].ulPropTag    =   PR_RULE_PROVIDER; rgPropVals[4].Value.lpszA  =   lpszProvider;

rgPropVals[5].ulPropTag    =   PR_RULE_LEVEL; rgPropVals[5].Value.ul     =   NULL;

rgPropVals[6].ulPropTag    =   PR_RULE_NAME; rgPropVals[6].Value.lpszA  =   lpszName;

rgPropVals[7].ulPropTag    =   PR_RULE_USER_FLAGS; rgPropVals[7].Value.ul     =   NULL;

rgPropVals[8].ulPropTag    =   PR_RULE_PROVIDER_DATA; rgPropVals[8].Value.ul     =   NULL;

lpRowList->cEntries = 1;

lpRowEntry = lpRowList->aEntries;

lpRowEntry->ulRowFlags  = ROW_ADD; lpRowEntry->cValues     = 9; lpRowEntry->rgPropVals  = (LPSPropValue)rgPropVals;

// Modify the RULE table

hr = m_lpExchTbl->ModifyTable(0, lpRowList);

if (FAILED(hr)) {       goto cleanup; }

cleanup:

ULRELEASE(m_lpExchTbl);

RETURN(hr); }

Keywords: kbapi kbmsg kbprb kbcode KB177623

-

[mailto:TECHNET@MICROSOFT.COM Send feedback to Microsoft]

© Microsoft Corporation. All rights reserved.