Add note about internal representation of .NET runtime types (#44672)

dotnet · Feb 4, 2025 · d2cb2d1 · d2cb2d1
1 parent 2029609
commit d2cb2d1
Showing 1 changed file with 2 additions and 0 deletions.
diff --git a/docs/standard/native-interop/best-practices.md b/docs/standard/native-interop/best-practices.md
@@ -400,6 +400,8 @@ Pointers to structs in definitions must either be passed by `ref` or use `unsafe
 
 ✔️ DO use the C# `sizeof()` instead of `Marshal.SizeOf<MyStruct>()` for blittable structures to improve performance.
 
+❌ DON'T depend on internal representation of struct types exposed by .NET runtime libraries unless it is explicitly documented.
+
 ❌ AVOID using classes to express complex native types through inheritance.
 
 ❌ AVOID using `System.Delegate` or `System.MulticastDelegate` fields to represent function pointer fields in structures.