ImageGear for C and C++ on Windows v21.0 - Updated
API Reference Guide / PDF Component API Reference / PDF Component Objects Reference / General Objects / HIG_PDF_DOC / IG_PDF_doc_set_new_security_data
In This Topic
    IG_PDF_doc_set_new_security_data
    In This Topic

    Sets the security data structure for the specified document's new security handler.

    Declaration:

     
    Copy Code
    AT_ERRCOUNT ACCUAPI IG_PDF_doc_set_new_security_data(
            HIG_PDF_DOC hDoc,
            LPAT_PDF_SECURITYDATA lpSecData
    );
    

    Arguments:

    Name Type Description
    hDoc HIG_PDF_DOC The document whose new security data structure is set.
    lppSecData LPAT_PDF_SECURITYDATA Pointer to the new security data structure to set for doc.

    Return Value:

    Error count.

    Supported Raster Image Formats:

    This function does not process image pixels.

    Remarks:

    The new security handler must have been previously set using IG_PDF_doc_set_new_crypt_handler.

    A warning is reported when an invalid combination of AT_PDF_SECURITYDATA properties encryptMethod, keyLength, version and revision are provided to this function. Attempting to secure a PDF with an invalid combination will result in a different, valid combination being used instead.

    See AT_PDF_SECURITYDATA for valid combinations.