सूचना: चक्रवृद्धि संदेश फ़ाइल में संदेश सहेजें


सारांश


इस आलेख में कोड प्रदर्शित करता है कि कैसे एक जटिल दस्तावेज़--में. msg फ़ाइल स्वरूप का समर्थन करता है जो किसी क्लाइंट द्वारा पढ़ने योग्य है, जो विशेष रूप से एक. msg फ़ाइल--करने के लिए किसी संदेश को सहेजने के लिए हैं।

अधिक जानकारी


नीचे फ़ंक्शन किसी मान्य संदेश ऑब्जेक्ट किसी में पैरामीटर के रूप में लेता है और इसके गुण. msg स्वरूप का उपयोग करते हुए एक संयुक्त फ़ाइल को सहेजें और संदेश की प्रतिलिपि बनाने के लिए का उपयोग करता है। संदेश की विषय पंक्ति नए फ़ाइल का फ़ाइल नाम के रूप में उपयोग किया जाता है।


नोट: विशेष वर्ण में पैरामीटर इस फ़ंक्शन की विषय पंक्ति में अनपेक्षित परिणाम हो सकती हैं। विशेष वर्णों की विषय पंक्ति में से बचने के लिए कोड लिखा जा सकता, जबकि germane विषय करने के लिए नहीं है और ऐसे कोड इरादतन छोड़ दिया जाता है।
#define INITGUID
#include <objbase.h>

#define USES_IID_IMessage

#include <mapix.h>
#include <mapitags.h>
#include <mapidefs.h>
#include <mapiutil.h>
#include <mapiguid.h>
#include <imessage.h>

// {00020D0B-0000-0000-C000-000000000046}
DEFINE_GUID(CLSID_MailMessage,
0x00020D0B,
0x0000, 0x0000, 0xC0, 0x00, 0x0, 0x00, 0x0, 0x00, 0x00, 0x46);

HRESULT SaveToMSG ( LPMESSAGE pMessage )
{
HRESULT hRes = S_OK;
LPSPropValue pSubject = NULL;
LPSTORAGE pStorage = NULL;
LPMSGSESS pMsgSession = NULL;
LPMESSAGE pIMsg = NULL;
SizedSPropTagArray ( 7, excludeTags );
char szPath[_MAX_PATH];
char strAttachmentFile[_MAX_PATH];
LPWSTR lpWideCharStr = NULL;
ULONG cbStrSize = 0L;

// create the file name in the directory where "TMP" is defined
// with subject as the filename and ".msg" extension.

// get temp file directory
GetTempPath(_MAX_PATH, szPath);

// get subject line of message to copy. This will be used as the
// new file name.
HrGetOneProp( pMessage, PR_SUBJECT, &pSubject );

// fuse path, subject, and suffix into one string
strcpy ( strAttachmentFile, szPath );
strcat ( strAttachmentFile, pSubject->Value.lpszA );
strcat ( strAttachmentFile, ".msg");

// get memory allocation function
LPMALLOC pMalloc = MAPIGetDefaultMalloc();

// Convert new file name to WideChar
cbStrSize = MultiByteToWideChar (CP_ACP,
MB_PRECOMPOSED,
strAttachmentFile,
-1, lpWideCharStr, 0);

MAPIAllocateBuffer ( cbStrSize * sizeof(WCHAR),
(LPVOID *)&lpWideCharStr );

MultiByteToWideChar (CP_ACP,
MB_PRECOMPOSED,
strAttachmentFile,
-1, lpWideCharStr, cbStrSize );

// create compound file
hRes = ::StgCreateDocfile(lpWideCharStr,
STGM_READWRITE |
STGM_TRANSACTED |
STGM_CREATE, 0, &pStorage);

// Open an IMessage session.
hRes = ::OpenIMsgSession(pMalloc, 0, &pMsgSession);

// Open an IMessage interface on an IStorage object
hRes = ::OpenIMsgOnIStg(pMsgSession,
MAPIAllocateBuffer,
MAPIAllocateMore,
MAPIFreeBuffer,
pMalloc,
NULL,
pStorage,
NULL, 0, 0, &pIMsg);

// write the CLSID to the IStorage instance - pStorage. This will
// only work with clients that support this compound document type
// as the storage medium. If the client does not support
// CLSID_MailMessage as the compound document, you will have to use
// the CLSID that it does support.
hRes = WriteClassStg(pStorage, CLSID_MailMessage );

// Specify properties to exclude in the copy operation. These are
// the properties that Exchange excludes to save bits and time.
// Should not be necessary to exclude these, but speeds the process
// when a lot of messages are being copied.
excludeTags.cValues = 7;
excludeTags.aulPropTag[0] = PR_ACCESS;
excludeTags.aulPropTag[1] = PR_BODY;
excludeTags.aulPropTag[2] = PR_RTF_SYNC_BODY_COUNT;
excludeTags.aulPropTag[3] = PR_RTF_SYNC_BODY_CRC;
excludeTags.aulPropTag[4] = PR_RTF_SYNC_BODY_TAG;
excludeTags.aulPropTag[5] = PR_RTF_SYNC_PREFIX_COUNT;
excludeTags.aulPropTag[6] = PR_RTF_SYNC_TRAILING_COUNT;

// copy message properties to IMessage object opened on top of
// IStorage.
hRes = pMessage->CopyTo(0, NULL,
(LPSPropTagArray)&excludeTags,
NULL, NULL,
(LPIID)&IID_IMessage,
pIMsg, 0, NULL );

// save changes to IMessage object.
pIMsg -> SaveChanges ( KEEP_OPEN_READWRITE );

// save changes in storage of new doc file
hRes = pStorage -> Commit(STGC_DEFAULT);

// free objects and clean up memory
MAPIFreeBuffer ( lpWideCharStr );
pStorage->Release();
pIMsg->Release();
CloseIMsgSession ( pMsgSession );

pStorage = NULL;
pIMsg = NULL;
pMsgSession = NULL;
lpWideCharStr = NULL;

return hRes;
}
CLSID_MailMessage संयुक्त दस्तावेज़ के रूप में Outlook और Exchange क्लाइंट के सभी संस्करणों का समर्थन है। जब आप संरचित संग्रह करने के लिए संदेश लिखते हैं जो किसी अन्य CLISD का उपयोग अन्य क्लाइंट्स का समर्थन करने के लिए कोई भिन्न CLSID का उपयोग करने के लिए एकमात्र कारण है।

जब प्राप्तकर्ताओं या संलग्नकों के बहुत पास संदेशों को सहेजते हैं, तो यह संभव CopyTo कार्रवाई MAPI_E_NOT_ENOUGH_MEMORY के साथ विफल हो जाएगा है। यह संरचित संग्रहण और स्ट्रीम के साथ कोई ज्ञात समस्या के कारण है। हर बार जब कोई नया अनुलग्नक या प्राप्तकर्ता है जोड़े संदेश में संरचित संग्रहण, सहेजा जा रहा एक नया रूट संग्रह फ़ाइल खोली है। ये फ़ाइलें बंद नहीं हैं, हस्तांतरण के पूरा होने तक। आपरेटिंग सिस्टम एक साथ खुला रूट संग्रह फ़ाइलों की संख्या पर एक सीमा imposes, क्योंकि वहाँ कोई ज्ञात समाधान है। अधिक जानकारी के लिए, Microsoft नॉलेज़ बेस में आलेख देखने के लिए निम्न आलेख संख्या पर क्लिक करें:

Simultaeously खोलें रूट संग्रह फ़ाइलों की संख्या की सीमा 163202
Outlook के सभी संस्करणों को भी इस सीमा से प्रभावित होते हैं।