UPDATE 3:
A developer at Microsoft has found official documentation. It is part of the Open Office XML standard, specifically the DocSecurity element: ISO/IEC 29500-1:2016 (Download the zip file and search the PDF in side for "DocSecurity".) There is some further information about how Microsoft has implemented it here: 2.1.1713 Part 1 Section 22.2.2.7, DocSecurity . This documentation confirms that the list in UPDATE 2 below is correct. (So, ignore the "(Probably)"s.) Also, it shows that the 16 values listed are the only possible values.
UPDATE 2:
Based on the OP's comment below, here is the updated list of values. I have not been able to verify the ones marked "(Probably)" but based on the pattern, I'm very confident that they are correct. This is not necessarily complete. There may be values higher than 15.
0 = File on disk is read/write
1 = Protect Document: File is encrypted and requires a password to open
2 = Protect Document: Always Open as Read-Only
3 = Protect Document: Both #1 above and #2
4 = File on disk is read only
5 = Both #1 above and #4 above
6 = Both #2 and #4
7 = (Probably) All of #1, #2, and #4
8 = Protect Document: Restrict Edit to read-only
9 = Both #1 and #8
10 = Both #2 and #8
11 = All of #1, #2, and #8
12 = (Probably) Both #4 and #8
13 = (Probably) All of #1, #4, and #8
14 = (Probably) All of #2, #4, and #8
15 = (Probably) All of #1, #2, #4, and #8
UPDATE:
It is not powers-of-2 and some of the values are connected with the Protect Document options in the File menu. Here are the values I've been able to discover:
0 = File on disk is read/write
1 = Protect Document: File is encrypted and requires a password to open
3 = Protect Document: Both #1 above and #6 below
4 = File on disk is read only
5 = Both #1 above and #4 above
6 = Protect Document: Always Open as Read-Only
8 = ?
Note that some of the Protect Document options disable Script Lab, so I can't test if they have a wdPropertySecurity
value. I think, but haven't tested, that they would block any add-in, so an add-in would never return these values if they exist.

ORIGINAL ANSWER:
I've gotten a bit of information from a developer on the Word team. The BuiltInDocumentProperties(wdPropertySecurity)
value refers to the properties of the document as a file on disk. When you set the view mode to read-only, you are not changing the access to the file on disk, so the wdPropertySecurity value should not change. If it was 0
, it should stay 0
. The developer discovered the meaning of 0
and 4
. Since you've seen 8
, it looks like these are powers-of-2, so there's probably a 2
as well. This is what the developer reports:
0 = read/write
2 = ?
4 = read only
8 = ?
I'll add to this if I discover more. In the meantime, can you provide the exact steps that lead to getting an 8
?