[Breaking change]: TrustedCertificatesDirectory and StartNewTlsSessionContext are not available on .NETStandard / .NETFramework

[ericstj]

Description

The following APIs were accidentally exposed in netstandard2.0

P:System.DirectoryServices.Protocols.LdapSessionOptions.TrustedCertificatesDirectory
M:System.DirectoryServices.Protocols.LdapSessionOptions.StartNewTlsSessionContext()

These are not implemented on .NETFramework and should not have been exposed from the netstandard2.0 assembly.

The bug existed in System.DirectoryServices.Protocols nuget package version 8.0.1 and was fixed in 8.0.2.

Version

.NET 8

Previous behavior

These APIs could be used from a netstandard2.0 library.

New behavior

These APIs are unavailable when targeting netstandard2.0

Type of breaking change

• Binary incompatible: Existing binaries might encounter a breaking change in behavior, such as failure to load or execute, and if so, require recompilation.
• Source incompatible: When recompiled using the new SDK or component or to target the new runtime, existing source code might require source changes to compile successfully.
• Behavioral change: Existing binaries might behave differently at run time.

Reason for change

The APIs did not work in all compatible frameworks.

Recommended action

If you need to use these APIs, target a .NET version that supports them.

Feature area

Core .NET libraries

Affected APIs

P:System.DirectoryServices.Protocols.LdapSessionOptions.TrustedCertificatesDirectory
M:System.DirectoryServices.Protocols.LdapSessionOptions.StartNewTlsSessionContext()

---

Associated WorkItem - 495674