Document.Unprotect Method (Word)

Removes protection from the specified document. .

Syntax

expression .UnProtect(Password)

expression Required. A variable that represents a Document object.

Parameters

Name

Required/Optional

Data Type

Description

Password

Optional

Variant

The password string used to protect the document. Passwords are case-sensitive. If the document is protected with a password and the correct password isn't supplied, a dialog box prompts the user for the password.

Security

Avoid using hard-coded passwords in your applications. If a password is required in a procedure, request the password from the user, store it in a variable, and then use the variable in your code. For recommended best practices on how to do this, see Security Notes for Microsoft Office Solution Developers.

Remarks

If the document isn't protected, this method generates an error.

Example

This example removes protection from the active document, using the value of the strPassword variable as the password.

If ActiveDocument.ProtectionType <> wdNoProtection Then 
 ActiveDocument.Unprotect Password:=strPassword 
End If

This example removes protection from the active document. Text is inserted, and the document is protected for revisions.

Set aDoc = ActiveDocument 
If aDoc.ProtectionType <> wdNoProtection Then 
 aDoc.Unprotect 
 Selection.InsertBefore "department six" 
 aDoc.Protect Type:=wdAllowOnlyRevisions, Password:=strPassword 
End If

See Also

Concepts

Document Object Members

Document Object