Add ACL constructor that tolerates files with unknown ACE types

contrib/platform/src/com/sun/jna/platform/win32/WinNT.java

@@ -23,6 +23,7 @@
  */
 package com.sun.jna.platform.win32;
 
+import java.util.ArrayList;
 import java.util.Collections;
 import java.util.List;
 
@@ -2553,8 +2554,6 @@ public static class ACL extends Structure {
         public short AceCount;
         public short Sbz2;
 
-        private ACCESS_ACEStructure[] ACEs;
-
         public ACL() {
             super();
         }
@@ -2567,30 +2566,42 @@ public ACL(int size) {
         public ACL(Pointer pointer) {
             super(pointer);
             read();
-            ACEs = new ACCESS_ACEStructure[AceCount];
+        }
+
+        public ACCESS_ACEStructure[] getACEStructures() {
+            return getACEStructures(false);
+        }
+
+        public ACCESS_ACEStructure[] getACEStructures(boolean tolerateUnknownAceTypes) {
+            final List<ACCESS_ACEStructure> ACEs = new ArrayList<ACCESS_ACEStructure>(AceCount);
+            final Pointer pointer = this.getPointer();
             int offset = size();
             for (int i = 0; i < AceCount; i++) {
-                Pointer share = pointer.share(offset);
-                // ACE_HEADER.AceType
-                final byte aceType = share.getByte(0);
-                ACCESS_ACEStructure ace;
+                final Pointer share = pointer.share(offset);
+                final byte aceType = share.getByte(0); // ACE_HEADER.AceType
+                final short aceSize;
                 switch (aceType) {
                     case ACCESS_ALLOWED_ACE_TYPE:
-                        ace = new ACCESS_ALLOWED_ACE(share);
+                        final ACCESS_ALLOWED_ACE allowedAce = new ACCESS_ALLOWED_ACE(share);
+                        aceSize = allowedAce.AceSize;
+                        ACEs.add(allowedAce);
                         break;
                     case ACCESS_DENIED_ACE_TYPE:
-                        ace = new ACCESS_DENIED_ACE(share);
+                        final ACCESS_DENIED_ACE deniedAce = new ACCESS_DENIED_ACE(share);
+                        aceSize = deniedAce.AceSize;
+                        ACEs.add(deniedAce);
                         break;
                     default:
-                        throw new IllegalArgumentException("Unknown ACE type " + aceType);
+                        if (! tolerateUnknownAceTypes) {
+                            throw new IllegalStateException("Unknown ACE type " + aceType);
+                        }
+                        final ACE_HEADER aceHeader = new ACE_HEADER(share);
+                        aceSize = aceHeader.AceSize;
+                        break;
                 }
-                ACEs[i] = ace;
-                offset += ace.AceSize;
+                offset += aceSize;
             }
-        }
-
-        public ACCESS_ACEStructure[] getACEStructures() {
-            return ACEs;
+            return ACEs.toArray(new ACCESS_ACEStructure[ACEs.size()]);
         }
 
         @Override