IPXC_Document::AuthorizeWithPassword Method

From PDF XChange PDF SDK
Jump to: navigation, search
m (Automatic page editing by robot)
m (Automatic page editing by robot)
 
(9 intermediate revisions by 2 users not shown)
Line 1: Line 1:
 +
__NOTOC__
 
[[Category:Editor]]
 
[[Category:Editor]]
 
{{#customTitle:IPXC_Document::AuthorizeWithPassword Method}}
 
{{#customTitle:IPXC_Document::AuthorizeWithPassword Method}}
{{#parentPage:PXV:IPXC_Document|method}}
+
{{#parentPage:PXV:IPXC_Document#Methods|AuthorizeWithPassword|method}}
{{ToWrite}}
+
 
{{ToReview}}
 
{{ToReview}}
  
The method of interface of PDF-XChange Editor SDK.
+
Tries to authorize documents, protected by <tt>Standard</tt> (Password protection) security handler, with specified password. Password specified as regular Unicode string that will be converted to UTF-8 or default ANSI code page depends of document security revision. If document is not protected by <tt>Standard</tt> security, the method will fail.
  
 
== Syntax ==
 
== Syntax ==
<pre class="brush:cpp;gutter:false">HRESULT AuthorizeWithPassword([in] LPWSTR pPwd, [out, retval] PXC_PermStatus* pStatus);</pre>
+
<pre class="brush:cpp;gutter:false">HRESULT AuthorizeWithPassword([in]           LPWSTR           sPwd,
 +
                              [out, retval] PXC_PermStatus* nStatus);</pre>
  
 
== Parameters ==
 
== Parameters ==
;''pPwd''
+
;sPwd
:[in] Value of LPWSTR.
+
:[in] Password to authorize.
;''pStatus''
+
;nStatus
:[out, retval] Pointer to [[PXV:PXC_PermStatus|PXC_PermStatus]].
+
:[out, retval] Returns [[PXV:PXC_PermStatus|PXC_PermStatus]] value that specifies if document was successfully authorized or not.
  
 
== Return Value ==
 
== Return Value ==
Returns S_OK if operation was successful or error code in other cases.
+
Returns <tt>S_OK</tt> if operation was successful or error code in other cases.
  
 
== See Also ==
 
== See Also ==
See also [[PXV:IPXC_Document|IPXC_Document]].
+
[[PXV:IPXC_Document|IPXC_Document]]

Latest revision as of 03:24, 15 June 2015


Tries to authorize documents, protected by Standard (Password protection) security handler, with specified password. Password specified as regular Unicode string that will be converted to UTF-8 or default ANSI code page depends of document security revision. If document is not protected by Standard security, the method will fail.

Syntax

HRESULT AuthorizeWithPassword([in]           LPWSTR           sPwd,
                              [out, retval]  PXC_PermStatus*  nStatus);

Parameters

sPwd
[in] Password to authorize.
nStatus
[out, retval] Returns PXC_PermStatus value that specifies if document was successfully authorized or not.

Return Value

Returns S_OK if operation was successful or error code in other cases.

See Also

IPXC_Document