Documentation – Outlook 저장 파일(PST/OST) 작업

Cpp: 새 PST 파일 생성 및 하위 폴더 추가

Mon, 01 Jan 0001 00:00:00 +0000

새 PST 파일 생성 및 하위 폴더 추가

기존 PST 파일을 구문 분석하는 것뿐만 아니라, Aspose.Email은 처음부터 PST 파일을 생성할 수 있는 방법을 제공합니다. 이 문서에서는 Outlook PST 파일을 만들고 그에 하위 폴더를 추가하는 방법을 보여줍니다.

새 PST 파일 생성.
폴더의 Container 클래스 변경.

PersonalStorage 클래스를 사용하여 로컬 디스크의 특정 위치에 PST 파일을 생성합니다. 처음부터 PST 파일을 만들려면:

PersonalStorage.Create() 메서드를 사용하여 PST를 생성합니다.
Root 폴더에 접근한 후 AddSubFolder 메서드를 호출하여 PST 파일 루트에 하위 폴더를 추가합니다.

다음 코드 스니펫은 PST 파일을 생성하고 Inbox라는 하위 폴더를 추가하는 방법을 보여줍니다.

폴더의 컨테이너 클래스 변경

때때로 폴더의 폴더 클래스를 변경해야 할 필요가 있습니다. 일반적인 예로 서로 다른 유형(약속, 메시지 등)의 메시지가 동일한 폴더에 추가되는 경우가 있습니다. 이런 경우 폴더의 모든 요소가 올바르게 표시되도록 폴더 클래스를 변경해야 합니다. 다음 코드 스니펫은 이 목적을 위해 PST에서 폴더의 컨테이너 클래스를 변경하는 방법을 보여줍니다.

Cpp: Outlook OST 파일 읽기 및 변환

Mon, 01 Jan 0001 00:00:00 +0000

Outlook OST 파일 읽기 및 변환

Aspose.Email for C++는 Microsoft Outlook OST 파일을 읽기 위한 API를 제공합니다. 디스크나 스트림에서 OST 파일을 로드하여 Aspose.Email.Outlook.Pst.PersonalStorage 클래스의 인스턴스로 가져오면 폴더, 하위 폴더, 메시지와 같은 내용 정보를 얻을 수 있습니다. Microsoft Outlook은 POP3 또는 IMAP 메일 서버를 사용해 메시지를 다운로드할 때 이메일을 저장하기 위해 PST 파일을 생성합니다. 메일 서버가 Microsoft Exchange인 경우 OST 파일을 생성합니다. OST는 PST 파일보다 더 큰 파일 크기를 지원합니다.

OST 파일 읽기

Aspose.Email를 사용하여 OST 파일을 읽는 과정은 PST 파일을 읽는 과정과 완전히 동일합니다. 동일한 코드를 사용하여 PST와 OST 파일을 모두 읽을 수 있습니다: PersonalStorage.FromFile() 메서드에 올바른 파일 이름만 전달하면 됩니다. 다음 코드 스니펫은 OST 파일을 읽는 방법을 보여줍니다.

OST를 PST로 변환

Aspose.Email를 사용하면 한 줄의 코드로 OST 파일을 PST로 변환할 수 있습니다. 마찬가지로 FileFormat 열거형을 사용한 동일한 한 줄의 코드로 PST 파일에서 OST 파일을 생성할 수 있습니다. 현재 API는 OST 2013/2016을 제외한 OST 형식을 PST로 변환하는 것을 지원합니다. 다음 코드 스니펫은 OST를 PST로 변환하는 방법을 보여줍니다.

Cpp: Outlook PST 파일을 읽고 폴더 및 하위 폴더 정보 가져오기

Mon, 01 Jan 0001 00:00:00 +0000

Outlook PST 파일을 읽고 폴더 및 하위 폴더 정보 가져오기

Aspose.Email for C++는 Microsoft Outlook PST 파일을 읽기 위한 API를 제공합니다. 디스크나 스트림에서 PST 파일을 로드하여 PersonalStorage 클래스 인스턴스로 가져오면 폴더, 하위 폴더, 메시지와 같은 내용 정보를 얻을 수 있습니다. 또한 API는 PST 폴더에서 메시지를 탐색할 때 검색 폴더를 포함할 수 있는 기능을 제공합니다.

PST 파일 로드

Outlook PST 파일을 PersonalStorage 클래스의 인스턴스로 로드할 수 있습니다. 다음 코드 스니펫은 PST 파일을 로드하는 방법을 보여줍니다.

폴더 정보 표시

PersonalStorage 클래스에서 PST 파일을 로드한 후 파일 표시 이름, 루트 폴더, 하위 폴더 및 메시지 수에 대한 정보를 얻을 수 있습니다. 다음 코드 스니펫은 PST 파일 이름, 폴더 이름 및 각 폴더의 메시지 수를 표시하는 방법을 보여줍니다.

MessageInfo에서 상위 폴더 정보 가져오기

다음 코드 스니펫은 MessageInfo에서 상위 폴더 정보를 가져오는 방법을 보여줍니다.

Cpp: PST 파일 분할 및 병합

Mon, 01 Jan 0001 00:00:00 +0000

PST 파일 분할 및 병합

Aspose.Email API는 단일 PST 파일을 원하는 크기의 여러 PST 파일로 분할할 수 있는 기능을 제공합니다. 또한 여러 PST 파일을 하나의 PST 파일로 병합할 수 있습니다. 분할 및 병합 작업은 이벤트를 추가하여 추적할 수 있습니다.

여러 PST 파일로 분할

다음 코드 스니펫은 여러 PST 파일을 분할하는 방법을 보여줍니다.

단일 PST로 병합

다음 코드 조각은 단일 PST 파일로 병합하는 방법을 보여줍니다:

다른 PST에서 폴더 병합

다음 코드 스니펫은 다른 PST에서 폴더를 병합하는 방법을 보여줍니다.

Cpp: PST 파일에서 캘린더 항목 작업

Mon, 01 Jan 0001 00:00:00 +0000

PST에 MapiCalendar 추가

새 PST 파일을 만들고 하위 폴더를 추가하기는 PST 파일을 생성하고 하위 폴더를 추가하는 방법을 보여줍니다. Aspose.Email을 사용하면 생성하거나 로드한 PST 파일의 캘린더 하위 폴더에 MapiCalendar를 추가할 수 있습니다. 아래는 PST에 MapiCalendar를 추가하는 단계입니다:

MapiCalendar 객체를 생성합니다.
생성자와 메서드를 사용하여 MapiCalendar 속성을 설정합니다.
PersonalStorage.Create() 메서드를 사용하여 PST를 생성합니다.
루트 폴더에 접근한 후 AddMapiMessageItem() 메서드를 호출하여 PST 파일 루트에 미리 정의된 폴더(Calendar)를 생성합니다.

다음 코드 스니펫은 MapiCalendar를 생성하고 새로 만든 PST 파일의 캘린더 폴더에 추가하는 방법을 보여줍니다.

PST에서 캘린더 항목을 ICS 형식으로 디스크에 저장

이 문서는 Outlook PST 파일에서 캘린더 항목에 접근하고 캘린더를 ICS 형식으로 디스크에 저장하는 방법을 보여줍니다. 캘린더 정보를 가져오기 위해 PersonalStorage 및 MapiCalendar 클래스를 사용합니다. 캘린더 항목을 저장하는 단계는 다음과 같습니다:

PersonalStorage 클래스에서 PST 파일을 로드합니다.
캘린더 폴더 탐색.
캘린더 폴더의 내용을 가져와 메시지 컬렉션을 얻습니다.
메시지 컬렉션을 반복합니다.
PersonalStorage.ExtractMessage() 메서드를 호출하여 MapiCalendar 클래스에서 캘린더 정보를 가져옵니다.
MapiCalendar.Save() 메서드를 호출하여 캘린더 항목을 ICS 형식으로 디스크에 저장합니다.

아래 프로그램은 디스크에서 PST 파일을 로드하고 모든 캘린더 항목을 ICS 형식으로 저장합니다. ICS 파일은 표준 ICS 캘린더 파일을 로드할 수 있는 다른 프로그램에서도 사용할 수 있습니다. Microsoft Outlook에서 열면 아래 스크린샷과 같은 형태로 표시됩니다.

|| | :- | 다음 코드 스니펫은 Outlook PST에서 캘린더 항목을 ICS 형식으로 내보내는 방법을 보여줍니다.

Cpp: PST 파일에서 연락처 작업

Mon, 01 Jan 0001 00:00:00 +0000

PST에 연락처 추가

Aspose.Email를 사용하면 생성하거나 로드한 PST 파일의 Contacts 하위 폴더에 MapiContact를 추가할 수 있습니다. 아래는 PST에 MapiContact를 추가하는 단계입니다:

MapiContact 객체를 생성합니다.
다양한 생성자와 메서드를 사용하여 MapiContact 속성을 설정합니다.
PersonalStorage.Create() 메서드를 사용하여 PST를 생성합니다.
루트 폴더에 접근한 후 AddMapiMessageItem() 메서드를 호출하여 PST 파일 루트에 미리 정의된 폴더(Contacts)를 생성합니다.

다음 코드 스니펫은 MapiContact를 생성한 다음 새로 만든 PST 파일의 연락처 폴더에 추가하는 방법을 보여줍니다.

PST 파일의 연락처 정보를 MSG 형식으로 저장

이 문서는 Outlook PST 파일에서 연락처 정보를 액세스하고 연락처를 MSG 형식으로 디스크에 저장하는 방법을 설명합니다. 연락처 정보를 가져오고 표시하기 위해 PersonalStorage 및 MapiContact 클래스를 사용합니다. 연락처 정보를 가져오는 단계는 다음과 같습니다:

PersonalStorage 클래스에서 PST 파일을 로드합니다.
Contacts 폴더를 탐색합니다.
Contacts 폴더의 내용을 가져와 메시지 컬렉션을 얻습니다.
메시지 컬렉션을 반복합니다.
PersonalStorage.ExtractContactInfo() 메서드를 호출하여 MapiContact 클래스에서 연락처 정보를 얻습니다. 연락처 정보에 접근하려면 MapiContact 클래스 속성을 사용하십시오.
PersonalStorage.ExtractMessage() 메서드를 호출하여 MapiMessage 클래스에서 연락처 정보를 가져옵니다.
MapiMessage.Save() 메서드를 호출하여 연락처를 MSG 형식으로 디스크에 저장합니다.

다음 코드 스니펫은 PST 파일에서 모든 연락처 정보를 가져와 MSG 형식으로 디스크에 저장하는 방법을 보여줍니다.

PST 파일의 연락처 정보를 VCF 형식으로 저장

이 문서는 Microsoft Outlook PST 파일에서 연락처 정보를 액세스하고 연락처를 vCard (VCF) 형식으로 디스크에 저장하는 방법을 보여줍니다. PST 파일에서 연락처 정보를 가져오기 위해 PersonalStorage 및 MapiContact 클래스를 사용합니다. 연락처 정보를 가져오는 방법은 다음과 같습니다:

PersonalStorage 클래스에서 PST 파일을 로드합니다.
Contacts 폴더를 탐색합니다.
Contacts 폴더의 내용을 가져와 메시지 컬렉션을 얻습니다.
메시지 컬렉션을 반복합니다.
PersonalStorage.ExtractMessage() 메서드를 호출하여 MapiContact 클래스에서 연락처 정보를 가져옵니다.
MapiContact 클래스의 다양한 속성을 사용하여 연락처 정보에 접근합니다.

아래 프로그램은 디스크에서 PST 파일을 로드하고 모든 연락처를 vCard (VCF) 형식으로 저장합니다. VCF 파일은 표준 vCard 연락처 파일을 로드할 수 있는 다른 프로그램에서도 사용할 수 있습니다. Microsoft Outlook에서 VCF 파일을 열면 아래 스크린샷과 같은 형태로 표시됩니다.

|| | :- | 다음 코드 스니펫은 Outlook PST에서 vCard (VCF) 형식으로 연락처를 내보내는 방법을 보여줍니다.

배포 목록 작업

Aspose.Email API를 사용하여 여러 연락처를 모은 배포 목록을 생성할 수 있습니다. 배포 목록은 Outlook MSG 형식으로 디스크에 저장될 수 있으며, MS Outlook에서 열어 확인/조작할 수 있습니다.

배포 목록 만들기 및 저장

다음 코드 스니펏은 배포 목록을 생성하고 저장하는 방법을 보여줍니다.

PST에서 배포 목록 읽기

다음 코드 스니펫은 PST에서 배포 목록을 읽는 방법을 보여줍니다.

Cpp: PST에서 MapiJournal 작업

Mon, 01 Jan 0001 00:00:00 +0000

PST에 MapiJournal 추가

Aspose.Email를 사용하면 생성하거나 로드한 PST 파일의 Journal 하위 폴더에 MapiJournal을 추가할 수 있습니다. 아래는 PST에 MapiJournal을 추가하는 단계입니다:

MapiJournal 객체를 생성합니다.
생성자와 메서드를 사용하여 MapiJournal 속성을 설정합니다.
PersonalStorage.Create() 메서드를 사용하여 PST를 생성합니다.
루트 폴더에 접근한 후 AddMapiMessageItem() 메서드를 호출하여 PST 파일 루트에 미리 정의된 폴더(Journals)를 생성합니다.

다음 코드 스니펫은 MapiJournal을 생성하고 새로 만든 PST 파일의 저널 폴더에 추가하는 방법을 보여줍니다.

MapiJournal에 첨부 파일 추가

다음 코드 스니펫은 MapiJournal에 첨부 파일을 추가하는 방법을 보여줍니다.

Cpp: PST에서 MapiNote 작업

Mon, 01 Jan 0001 00:00:00 +0000

PST에 MapiNote 추가

Aspose.Email를 사용하면 생성하거나 로드한 PST 파일의 Notes 하위 폴더에 MapiNote를 추가할 수 있습니다. PST에 MapiNote를 추가하려면:

Microsoft Outlook을 사용해 템플릿 MapiNote를 만들고 MSG 파일로 저장합니다.
저장된 MSG 노트를 MapiMessage 객체에 로드합니다.
MapiNote 객체를 생성하고 템플릿 MSG 노트를 로드합니다.
MapiNote 속성을 설정합니다.
PersonalStorage.Create() 메서드를 사용하여 PST를 생성합니다.
루트 폴더에 접근한 후 AddMapiMessageItem() 메서드를 호출하여 PST 파일 루트에 사전 정의된 폴더(노트)를 생성합니다.

다음 코드 스니펫은 MapiNote를 생성하고 새로 만든 PST 파일의 노트 폴더에 추가하는 방법을 보여줍니다.

Cpp: PST에서 MapiTask 작업

Mon, 01 Jan 0001 00:00:00 +0000

PST에 MapiTask 추가

Aspose.Email를 사용하면 생성하거나 로드한 PST 파일의 Tasks 하위 폴더에 MapiTask를 추가할 수 있습니다. 아래는 PST에 MapiTask를 추가하는 단계입니다:

MapiTask 객체를 생성합니다.
생성자와 다양한 메서드를 사용하여 MapiTask 속성을 설정합니다.
PersonalStorage.Create() 메서드를 사용하여 PST를 생성합니다.
Root 폴더에 액세스한 다음 AddMapiMessageItem() 메서드를 호출하여 PST 파일 루트에 사전 정의된 폴더(Tasks)를 생성합니다.

다음 코드 스니펫은 MapiTask를 생성하고 새로 만든 PST 파일의 작업 폴더에 추가하는 방법을 보여줍니다.

Cpp: PST 파일에서 메시지 작업

Mon, 01 Jan 0001 00:00:00 +0000

PST 파일에 메시지 추가

Create a New PST File and Add Subfolders에서는 PST 파일을 생성하고 하위 폴더를 추가하는 방법을 보여줍니다. Aspose.Email를 사용하면 생성하거나 로드한 PST 파일의 하위 폴더에 메시지를 추가할 수 있습니다. 이 문서에서는 디스크에서 두 개의 메시지를 PST의 Inbox 하위 폴더에 추가합니다. PersonalStorage 및 FolderInfo 클래스를 사용하여 PST 파일에 메시지를 추가합니다. PST 파일의 Inbox 폴더에 메시지를 추가하려면:

FolderInfo 클래스의 인스턴스를 생성하고 Inbox 폴더의 내용을 로드합니다.
FolderInfo.AddMessage() 메서드를 호출하여 디스크에서 메시지를 Inbox 폴더에 추가합니다. FolderInfo 클래스는 폴더에 대량의 메시지를 추가할 수 있는 AddMessages 메서드를 제공하여 디스크 I/O를 감소시키고 성능을 향상시킵니다. 전체 예제는 아래 ‘Adding Bulk Messages’ 섹션에 있습니다.

아래 코드 스니펫은 Inbox라는 PST 하위 폴더에 메시지를 추가하는 방법을 보여줍니다.

PST에서 스트림으로 직접 메시지 저장

PST 파일에서 메시지를 직접 스트림에 저장하려면 MsgInfo를 추출하지 말고 SaveMessageToStream() 메서드를 사용합니다. 다음 코드 스니펫은 PST에서 스트림으로 직접 메시지를 저장하는 방법을 보여줍니다.

PST 파일에서 n개의 메시지 추출

다음 코드 조각은 PST에서 지정된 개수의 메시지를 추출하는 방법을 보여줍니다. 첫 번째 메시지의 인덱스와 추출할 메시지 총 개수를 제공하기만 하면 됩니다.

기준에 따라 PST에서 메시지 및 폴더 검색

Personal Storage(PST) 파일은 방대한 데이터를 포함할 수 있으며, 이러한 큰 파일에서 특정 기준을 만족하는 데이터를 검색하려면 코드에 여러 체크 포인트를 두어 정보를 필터링해야 합니다. PersonalStorageQueryBuilder 클래스를 사용하면 Aspose.Email가 지정된 검색 기준에 따라 PST에서 특정 레코드를 검색할 수 있습니다. PST는 발신자, 수신자, 제목, 메시지 중요도, 첨부 파일 존재 여부, 메시지 크기, 메시지 ID 등 다양한 검색 매개변수를 기반으로 메시지를 검색할 수 있습니다. 또한 PersonalStorageQueryBuilder를 사용하여 하위 폴더를 검색할 수도 있습니다.

PST에서 메시지 및 폴더 검색

다음 코드 스니펫은 PersonalStorageQueryBuilder 클래스를 사용하여 다양한 검색 기준에 따라 PST 내 콘텐츠를 검색하는 방법을 보여줍니다. 예를 들어, 다음과 같은 기준으로 PST를 검색합니다:

메시지 중요도.
메시지 클래스.
첨부 파일 존재 여부.
메시지 크기.
읽지 않은 메시지.
첨부 파일이 있는 읽지 않은 메시지, 그리고
특정 하위 폴더 이름을 가진 폴더.

전체 메시지를 추출하지 않고 첨부 파일 추출

Aspose.Email API를 사용하면 전체 메시지를 먼저 추출하지 않고도 PST 메시지에서 첨부 파일을 추출할 수 있습니다. IEWSClient의 ExtractAttachments 메서드를 사용하면 됩니다. 다음 코드 스니펫은 전체 메시지를 추출하지 않고 첨부 파일을 추출하는 방법을 보여줍니다.

PST에 파일 추가

Microsoft Outlook의 주요 기능은 이메일, 캘린더, 작업, 연락처 및 저널 항목을 관리하는 것입니다. 추가로 파일을 PST 폴더에 추가할 수 있으며, PST는 추가된 문서를 기록합니다. Aspose.Email는 PST에 메시지, 연락처, 작업, 저널 항목을 추가하는 것과 동일한 방식으로 파일을 폴더에 추가하는 기능을 제공합니다. 다음 코드 스니펫은 Aspose.Email를 사용하여 PST 폴더에 문서를 추가하는 방법을 보여줍니다.

Cpp: PST 비밀번호 보호 속성 작업

Mon, 01 Jan 0001 00:00:00 +0000

PST 비밀번호 보호 속성 작업

Microsoft Outlook은 사용자가 PST 파일에 비밀번호를 설정해 접근을 제한할 수 있게 합니다. Aspose.Email는 PST 파일의 비밀번호 보호 여부를 감지할 수 있습니다. 이 문서에서는 다음 방법을 보여줍니다:

PST에서 비밀번호 속성을 제거/재설정
PST 비밀번호 설정/변경

PR_PST_PASSWORD 속성 제거/재설정

PR_PST_PASSWORD 속성을 제거하려면 메시지 저장소에서 다른 속성이 제거되는 문제 때문에 직접 제거할 수 없습니다. 대신 해당 값을 0으로 설정해야 제거됩니다. PST 클래스의 "Store" 속성을 사용하면 PST의 MessageStoreProperties 대신 PST 저장소 속성에 접근할 수 있습니다. 다음 코드 스니펫은 PR_PST_PASSWORD 속성을 제거/재설정하는 방법을 보여줍니다.

PST 파일에 비밀번호 설정

다음 코드 스니펫은 PST 파일에 비밀번호를 설정하는 방법을 보여줍니다.