summaryrefslogtreecommitdiff
path: root/include/mupdf/fitz/document.h
diff options
context:
space:
mode:
Diffstat (limited to 'include/mupdf/fitz/document.h')
-rw-r--r--include/mupdf/fitz/document.h9
1 files changed, 9 insertions, 0 deletions
diff --git a/include/mupdf/fitz/document.h b/include/mupdf/fitz/document.h
index c66dc2ca..90b54b26 100644
--- a/include/mupdf/fitz/document.h
+++ b/include/mupdf/fitz/document.h
@@ -195,6 +195,15 @@ int fz_needs_password(fz_context *ctx, fz_document *doc);
specifications do not specify any particular text encoding, so
neither do we.
+ Returns 0 for failure to authenticate, non-zero for success.
+
+ For PDF documents, further information can be given by examining
+ the bits in the return code.
+
+ Bit 0 => No password required
+ Bit 1 => User password authenticated
+ Bit 2 => Owner password authenticated
+
Does not throw exceptions.
*/
int fz_authenticate_password(fz_context *ctx, fz_document *doc, const char *password);