Why is "updateDocSecurity()" is not running as documented?

Question

updateDocSecurity() doesn't seem to be documented correctly and is not executing as expected in these scenarios:

* Running

pdfDoc.updateDocSecurity("123456", "123456", "RC4", "OPEN")​

returns this error:

TypeError: updateDocSecurity() takes from 2 to 4 positional arguments but 5 were given​

* Running

pdfDoc.updateDocSecurity("123456", "123456", "RC4")​

results in the process running forever.

* Running

pdfDoc.updateDocSecurity("", "", "RC4")​

results in the process running successfully.

Any idea what's going on?

ArcGIS Pro 2.8.3

danretired · Answer

Tech Support is your best bet.  I can't find anything listed on the public support site.

JoshMakesMaps · Answer

It's still spinning forever after adjusting the script:

# Update PDF security.
            pdfDoc.updateDocSecurity(new_master_password="password123")

and

# Update PDF security.
            pdfDoc.updateDocSecurity("password123")

danretired · Answer

Using named parameters, as in my example, ensures that you have the correct parameter names.

The first parameter is required and must be known.

The second parameter is optional and its default is None.

If it is spinning, check your first parameter