Documentation – Manage PDF passwords and permissions in C++

Cpp: Change Password of PDF File in C++

Mon, 09 Nov 2026 00:00:00 +0000

Use PdfFileSecurity for this task. The examples below retain the original C++ code and API Reference steps.

Change password and reset security

Change both passwords using the existing owner password and reset privileges to printing only with x128 key size.

Configure the permission flags with DocumentPrivilege.
Create PdfFileSecurity.
Bind the PDF input with Facade::BindPdf().
Change passwords and security settings with PdfFileSecurity::ChangePassword().
Save the resulting PDF with PdfFileSecurity::Save().
Close the facade with PdfFileSecurity::Close().

#include <Aspose.PDF.Cpp/Facades/DocumentPrivilege.h>
#include <Aspose.PDF.Cpp/Facades/KeySize.h>
#include <Aspose.PDF.Cpp/Facades/PdfFileSecurity.h>
#include <system/string.h>

namespace Facades::Examples::PDF_FileSecurity
{
using namespace System;
using namespace Aspose::Pdf;
using namespace Aspose::Pdf::Facades;

void ChangePasswordAndResetSecurity(String inputFile, String outputFile)
{
    auto fileSecurity = MakeObject<PdfFileSecurity>();
    fileSecurity->BindPdf(inputFile);
    auto privilege = DocumentPrivilege::get_ForbidAll();
    privilege->set_AllowPrint(true);
    fileSecurity->ChangePassword(u"owner_password", u"new_user_password", u"new_owner_password", privilege,
                                 KeySize::x128);
    fileSecurity->Save(outputFile);
    fileSecurity->Close();
}
} // namespace Facades::Examples::PDF_FileSecurity

Change user and owner password

Change the user and owner passwords using the existing owner password.

Create PdfFileSecurity.
Bind the PDF input with Facade::BindPdf().
Change passwords and security settings with PdfFileSecurity::ChangePassword().
Save the resulting PDF with PdfFileSecurity::Save().
Close the facade with PdfFileSecurity::Close().

#include <Aspose.PDF.Cpp/Facades/PdfFileSecurity.h>
#include <system/string.h>

namespace Facades::Examples::PDF_FileSecurity
{
using namespace System;
using namespace Aspose::Pdf;
using namespace Aspose::Pdf::Facades;

void ChangeUserAndOwnerPassword(String inputFile, String outputFile)
{
    auto fileSecurity = MakeObject<PdfFileSecurity>();
    fileSecurity->BindPdf(inputFile);
    fileSecurity->ChangePassword(u"owner_password", u"new_user_password", u"new_owner_password");
    fileSecurity->Save(outputFile);
    fileSecurity->Close();
}
} // namespace Facades::Examples::PDF_FileSecurity

Try change password without exception

Check TryChangePassword and save only when it returns true; otherwise print a diagnostic.

Create PdfFileSecurity.
Bind the PDF input with Facade::BindPdf().
Attempt the password change and check the result of PdfFileSecurity::TryChangePassword().
Save the PDF with PdfFileSecurity::Save() only after the operation succeeds.
Close the facade with PdfFileSecurity::Close().
Print the results or diagnostic messages shown in the example.

#include <Aspose.PDF.Cpp/Facades/PdfFileSecurity.h>
#include <iostream>
#include <system/string.h>

namespace Facades::Examples::PDF_FileSecurity
{
using namespace System;
using namespace Aspose::Pdf;
using namespace Aspose::Pdf::Facades;

void TryChangePasswordWithoutException(String inputFile, String outputFile)
{
    auto fileSecurity = MakeObject<PdfFileSecurity>();
    fileSecurity->BindPdf(inputFile);
    if (fileSecurity->TryChangePassword(u"owner_password", u"new_user_password", u"new_owner_password"))
    {
        fileSecurity->Save(outputFile);
    }
    else
    {
        std::cout << "Password change failed. Check owner password or document security." << std::endl;
    }
    fileSecurity->Close();
}
} // namespace Facades::Examples::PDF_FileSecurity

Cpp: Decrypt PDF File in C++

Mon, 09 Nov 2026 00:00:00 +0000

Use PdfFileSecurity for this task. The examples below retain the original C++ code and API Reference steps.

Decrypt PDF with owner password

Decrypt the PDF using the owner password and save the result.

Create PdfFileSecurity.
Bind the PDF input with Facade::BindPdf().
Decrypt the bound PDF with PdfFileSecurity::MfDecryptFile().
Save the resulting PDF with PdfFileSecurity::Save().
Close the facade with PdfFileSecurity::Close().

#include <Aspose.PDF.Cpp/Facades/PdfFileSecurity.h>
#include <system/string.h>

namespace Facades::Examples::PDF_FileSecurity
{
using namespace System;
using namespace Aspose::Pdf;
using namespace Aspose::Pdf::Facades;

void DecryptPdfWithOwnerPassword(String inputFile, String outputFile)
{
    auto fileSecurity = MakeObject<PdfFileSecurity>();
    fileSecurity->BindPdf(inputFile);
    fileSecurity->MfDecryptFile(u"owner_password");
    fileSecurity->Save(outputFile);
    fileSecurity->Close();
}
} // namespace Facades::Examples::PDF_FileSecurity

Try decrypt PDF without exception

Check TryDecryptFile and save only when it returns true; otherwise print a diagnostic.

Create PdfFileSecurity.
Bind the PDF input with Facade::BindPdf().
Attempt decryption and check the result of PdfFileSecurity::TryDecryptFile().
Save the PDF with PdfFileSecurity::Save() only after the operation succeeds.
Close the facade with PdfFileSecurity::Close().
Print the results or diagnostic messages shown in the example.

#include <Aspose.PDF.Cpp/Facades/PdfFileSecurity.h>
#include <iostream>
#include <system/string.h>

namespace Facades::Examples::PDF_FileSecurity
{
using namespace System;
using namespace Aspose::Pdf;
using namespace Aspose::Pdf::Facades;

void TryDecryptPdfWithoutException(String inputFile, String outputFile)
{
    auto fileSecurity = MakeObject<PdfFileSecurity>();
    fileSecurity->BindPdf(inputFile);
    if (fileSecurity->TryDecryptFile(u"owner_password"))
    {
        fileSecurity->Save(outputFile);
    }
    else
    {
        std::cout << "Decryption failed. Check password or document security." << std::endl;
    }
    fileSecurity->Close();
}
} // namespace Facades::Examples::PDF_FileSecurity

Cpp: Encrypt PDF File in C++

Mon, 09 Nov 2026 00:00:00 +0000

Use PdfFileSecurity for this task. The examples below retain the original C++ code and API Reference steps.

Encrypt PDF with encryption algorithm

Encrypt with AES, x256 key size, and printing allowed.

Configure the permission flags with DocumentPrivilege.
Create PdfFileSecurity.
Bind the PDF input with Facade::BindPdf().
Encrypt the bound PDF with PdfFileSecurity::MfEncryptFile().
Save the resulting PDF with PdfFileSecurity::Save().
Close the facade with PdfFileSecurity::Close().

#include <Aspose.PDF.Cpp/Facades/Algorithm.h>
#include <Aspose.PDF.Cpp/Facades/DocumentPrivilege.h>
#include <Aspose.PDF.Cpp/Facades/KeySize.h>
#include <Aspose.PDF.Cpp/Facades/PdfFileSecurity.h>
#include <system/string.h>

namespace Facades::Examples::PDF_FileSecurity
{
using namespace System;
using namespace Aspose::Pdf;
using namespace Aspose::Pdf::Facades;

void EncryptPdfWithEncryptionAlgorithm(String inputFile, String outputFile)
{
    auto fileSecurity = MakeObject<PdfFileSecurity>();
    fileSecurity->BindPdf(inputFile);
    auto privilege = DocumentPrivilege::get_ForbidAll();
    privilege->set_AllowPrint(true);
    fileSecurity->MfEncryptFile(u"user_password", u"owner_password", privilege, KeySize::x256, Algorithm::AES);
    fileSecurity->Save(outputFile);
    fileSecurity->Close();
}
} // namespace Facades::Examples::PDF_FileSecurity

Encrypt PDF with permissions

Encrypt with x128 key size while disabling printing and copying from an initially AllowAll privilege set.

Configure the permission flags with DocumentPrivilege.
Create PdfFileSecurity.
Bind the PDF input with Facade::BindPdf().
Encrypt the bound PDF with PdfFileSecurity::MfEncryptFile().
Save the resulting PDF with PdfFileSecurity::Save().
Close the facade with PdfFileSecurity::Close().

#include <Aspose.PDF.Cpp/Facades/DocumentPrivilege.h>
#include <Aspose.PDF.Cpp/Facades/KeySize.h>
#include <Aspose.PDF.Cpp/Facades/PdfFileSecurity.h>
#include <system/string.h>

namespace Facades::Examples::PDF_FileSecurity
{
using namespace System;
using namespace Aspose::Pdf;
using namespace Aspose::Pdf::Facades;

void EncryptPdfWithPermissions(String inputFile, String outputFile)
{
    auto fileSecurity = MakeObject<PdfFileSecurity>();
    fileSecurity->BindPdf(inputFile);
    auto privilege = DocumentPrivilege::get_AllowAll();
    privilege->set_AllowPrint(false);
    privilege->set_AllowCopy(false);
    fileSecurity->MfEncryptFile(u"user_password", u"owner_password", privilege, KeySize::x128);
    fileSecurity->Save(outputFile);
    fileSecurity->Close();
}
} // namespace Facades::Examples::PDF_FileSecurity

Encrypt PDF with user owner password

Encrypt with sample user and owner passwords, x128 key size, and printing allowed.

Configure the permission flags with DocumentPrivilege.
Create PdfFileSecurity.
Bind the PDF input with Facade::BindPdf().
Encrypt the bound PDF with PdfFileSecurity::MfEncryptFile().
Save the resulting PDF with PdfFileSecurity::Save().
Close the facade with PdfFileSecurity::Close().

#include <Aspose.PDF.Cpp/Facades/DocumentPrivilege.h>
#include <Aspose.PDF.Cpp/Facades/KeySize.h>
#include <Aspose.PDF.Cpp/Facades/PdfFileSecurity.h>
#include <system/string.h>

namespace Facades::Examples::PDF_FileSecurity
{
using namespace System;
using namespace Aspose::Pdf;
using namespace Aspose::Pdf::Facades;

void EncryptPdfWithUserOwnerPassword(String inputFile, String outputFile)
{
    auto fileSecurity = MakeObject<PdfFileSecurity>();
    fileSecurity->BindPdf(inputFile);
    auto privilege = DocumentPrivilege::get_ForbidAll();
    privilege->set_AllowPrint(true);
    fileSecurity->MfEncryptFile(u"user_password", u"owner_password", privilege, KeySize::x128);
    fileSecurity->Save(outputFile);
    fileSecurity->Close();
}
} // namespace Facades::Examples::PDF_FileSecurity

Cpp: Set Privileges on an Existing PDF File in C++

Mon, 09 Nov 2026 00:00:00 +0000

Use PdfFileSecurity for this task. The examples below retain the original C++ code and API Reference steps.

Set PDF privileges with passwords

Set printing allowed and copying disabled using the supplied sample passwords.

Configure the permission flags with DocumentPrivilege.
Create PdfFileSecurity.
Bind the PDF input with Facade::BindPdf().
Apply document privileges with PdfFileSecurity::SetPrivilege().
Save the resulting PDF with PdfFileSecurity::Save().
Close the facade with PdfFileSecurity::Close().

#include <Aspose.PDF.Cpp/Facades/DocumentPrivilege.h>
#include <Aspose.PDF.Cpp/Facades/PdfFileSecurity.h>
#include <system/string.h>

namespace Facades::Examples::PDF_FileSecurity
{
using namespace System;
using namespace Aspose::Pdf;
using namespace Aspose::Pdf::Facades;

void SetPdfPrivilegesWithPasswords(String inputFile, String outputFile)
{
    auto fileSecurity = MakeObject<PdfFileSecurity>();
    fileSecurity->BindPdf(inputFile);
    auto privilege = DocumentPrivilege::get_ForbidAll();
    privilege->set_AllowPrint(true);
    privilege->set_AllowCopy(false);
    fileSecurity->SetPrivilege(u"user_password", u"owner_password", privilege);
    fileSecurity->Save(outputFile);
    fileSecurity->Close();
}
} // namespace Facades::Examples::PDF_FileSecurity

Set PDF privileges without passwords

Set a printing-only privilege set using the overload without password arguments.

Configure the permission flags with DocumentPrivilege.
Create PdfFileSecurity.
Bind the PDF input with Facade::BindPdf().
Apply document privileges with PdfFileSecurity::SetPrivilege().
Save the resulting PDF with PdfFileSecurity::Save().
Close the facade with PdfFileSecurity::Close().

#include <Aspose.PDF.Cpp/Facades/DocumentPrivilege.h>
#include <Aspose.PDF.Cpp/Facades/PdfFileSecurity.h>
#include <system/string.h>

namespace Facades::Examples::PDF_FileSecurity
{
using namespace System;
using namespace Aspose::Pdf;
using namespace Aspose::Pdf::Facades;

void SetPdfPrivilegesWithoutPasswords(String inputFile, String outputFile)
{
    auto fileSecurity = MakeObject<PdfFileSecurity>();
    fileSecurity->BindPdf(inputFile);
    auto privilege = DocumentPrivilege::get_ForbidAll();
    privilege->set_AllowPrint(true);
    fileSecurity->SetPrivilege(privilege);
    fileSecurity->Save(outputFile);
    fileSecurity->Close();
}
} // namespace Facades::Examples::PDF_FileSecurity

Try set PDF privileges without exception

Check TrySetPrivilege and save only when it returns true; otherwise print a diagnostic.

Configure the permission flags with DocumentPrivilege.
Create PdfFileSecurity.
Bind the PDF input with Facade::BindPdf().
Attempt the privilege update and check the result of PdfFileSecurity::TrySetPrivilege().
Save the PDF with PdfFileSecurity::Save() only after the operation succeeds.
Close the facade with PdfFileSecurity::Close().
Print the results or diagnostic messages shown in the example.

#include <Aspose.PDF.Cpp/Facades/DocumentPrivilege.h>
#include <Aspose.PDF.Cpp/Facades/PdfFileSecurity.h>
#include <iostream>
#include <system/string.h>

namespace Facades::Examples::PDF_FileSecurity
{
using namespace System;
using namespace Aspose::Pdf;
using namespace Aspose::Pdf::Facades;

void TrySetPdfPrivilegesWithoutException(String inputFile, String outputFile)
{
    auto fileSecurity = MakeObject<PdfFileSecurity>();
    fileSecurity->BindPdf(inputFile);
    auto privilege = DocumentPrivilege::get_ForbidAll();
    privilege->set_AllowPrint(true);
    if (fileSecurity->TrySetPrivilege(u"user_password", u"owner_password", privilege))
    {
        fileSecurity->Save(outputFile);
    }
    else
    {
        std::cout << "Setting privileges failed. Check passwords or document state." << std::endl;
    }
    fileSecurity->Close();
}
} // namespace Facades::Examples::PDF_FileSecurity