UnProtect Method

Microsoft Word Visual Basic

UnProtect Method

Removes protection from the specified document. If the document isn't protected, this method generates an error.

expression .UnProtect(Password)

expression    Required. An expression that returns a Document object.

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.

Remarks

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.

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