windows: comment on fields omitted from the win32finddata1 struct

Updates golang/go#42637 Change-Id: I2e8c95af3cf2172c55bda6a15a749afcc6c45581 Reviewed-on: https://go-review.googlesource.com/c/sys/+/284172 Trust: Bryan C. Mills <[email protected]> Trust: Jason A. Donenfeld <[email protected]> Trust: Alex Brainman <[email protected]> Run-TryBot: Bryan C. Mills <[email protected]> TryBot-Result: Go Bot <[email protected]> Reviewed-by: Jason A. Donenfeld <[email protected]> Reviewed-by: Alex Brainman <[email protected]>
golang · Feb 19, 2021 · 57ea560 · 57ea560
1 parent 3351caf
commit 57ea560
Showing 1 changed file with 8 additions and 0 deletions.
diff --git a/windows/types_windows.go b/windows/types_windows.go
@@ -794,6 +794,14 @@ type win32finddata1 struct {
 	Reserved1         uint32
 	FileName          [MAX_PATH]uint16
 	AlternateFileName [14]uint16
+
+	// The Microsoft documentation for this struct¹ describes three additional
+	// fields: dwFileType, dwCreatorType, and wFinderFlags. However, those fields
+	// are empirically only present in the macOS port of the Win32 API,² and thus
+	// not needed for binaries built for Windows.
+	//
+	// ¹ https://docs.microsoft.com/en-us/windows/win32/api/minwinbase/ns-minwinbase-win32_find_dataw describe
+	// ² https://golang.org/issue/42637#issuecomment-760715755.
 }
 
 func copyFindData(dst *Win32finddata, src *win32finddata1) {