feat(native): screenshot capture (windows) (#13064)

* feat(native): screenshot capture (windows)

* Tweak the description & drop the alert

* Link to Native from the product page for Screenshots

* Apply suggestions from code review

Co-authored-by: Alex Krawiec <[email protected]>

---------

Co-authored-by: Alex Krawiec <[email protected]>

Author: jpnurmi

docs/platforms/native/common/enriching-events/screenshots/img/screenshot-list-example.png

@@ -0,0 +1,24 @@
+---
+title: "Screenshots"
+description: "Learn more about taking screenshots when an error occurs. Sentry pairs the screenshot with the original event, giving you additional insight into issues."
+---
+
+Sentry makes it possible to automatically take a screenshot and include it as an <PlatformLink to="/enriching-events/attachments/">attachment</PlatformLink> when a user experiences an error, an exception, or a crash.
+
+This feature is currently only available on Windows and has a few limitations. For example, the `inproc` and `breakpad` backends use local exception handlers for capturing the screenshot and therefore rely on the exception handler being called. Only the `crashpad` backend with an external handler process is able to capture screenshots of fast-fail crashes that bypass Structured Exception Handling ([`SEH`](https://learn.microsoft.com/en-us/windows/win32/debug/structured-exception-handling)). Another example where a screenshot might not be available is when the event happens before the screen starts to load. So inherently, this feature is a best effort solution.
+
+## Enabling Screenshots
+
+Because screenshots may contain <PlatformLink to="/data-management/sensitive-data/">PII</PlatformLink>, they are an opt-in feature. You can enable screenshots as shown below:
+
+<PlatformContent includePath="enriching-events/attach-screenshots" />
+
+## Viewing Screenshots
+
+If one is available, you'll see a thumbnail of the screenshot when you click on a specific issue from the [**Issues**](https://demo.sentry.io/issues/) page.
+
+![Screenshot Thumbnail](./img/screenshot-thumbnail.png)
+
+Once you've clicked on the event ID of a specific issue, you'll be able to see an overview of all the attachments as well as associated events in the "Attachments" tab.
+
+![Screenshots List Example](./img/screenshot-list-example.png)

docs/platforms/native/common/enriching-events/screenshots/img/screenshot-thumbnail.png

@@ -151,6 +151,7 @@ Sentry provides the ability to take a screenshot and include it as an attachment
 - [Flutter](/platforms/dart/guides/flutter/enriching-events/screenshots/)
 - [iOS](/platforms/apple/guides/ios/enriching-events/screenshots/)
 - [JavaScript Electron](/platforms/javascript/guides/electron/enriching-events/screenshots/)
+- [Native](/platforms/native/enriching-events/screenshots/)
 - [React Native](/platforms/react-native/enriching-events/screenshots/)
 - [Unity](/platforms/unity/enriching-events/screenshots/)
 - [Unreal Engine](/platforms/unreal/enriching-events/screenshots/)

docs/platforms/native/common/enriching-events/screenshots/index.mdx

@@ -0,0 +1,3 @@
+```c
+sentry_options_set_attach_screenshot(options, true);
+```