System.DirectoryServices docs

Author: ericstj

xml/System.DirectoryServices.Protocols/LdapSessionOptions.xml

@@ -614,7 +614,10 @@
       </ReturnValue>
       <Parameters />
       <Docs>
-        <summary>To be added.</summary>
+        <summary>
+          <para>Create a new TLS library context.</para>
+          <para>Calling this is necessary after setting TLS-based options, such as <c>TrustedCertificatesDirectory</c>.</para>
+        </summary>
         <remarks>To be added.</remarks>
       </Docs>
     </Member>
@@ -718,9 +721,16 @@
         <ReturnType>System.String</ReturnType>
       </ReturnValue>
       <Docs>
-        <summary>To be added.</summary>
+        <summary>
+          <para>Specifies the path of the directory containing CA certificates in the PEM format.</para>
+          <para>Multiple directories may be specified by separating with a semi-colon.</para>
+        </summary>
         <value>To be added.</value>
-        <remarks>To be added.</remarks>
+        <remarks>
+          <para>The certificate files are looked up by the CA subject name hash value where that hash can be obtained by using, for example, <code>openssl x509 -hash -noout -in CA.crt</code>.</para>
+          <para>It is a common practice to have the certificate file be a symbolic link to the actual certificate file which can be done by using <code>openssl rehash .</code> or <code>c_rehash .</code> in the directory containing the certificate files.</para>
+        </remarks>
+        <exception cref="T:System.IO.DirectoryNotFoundException">The directory does not exist.</exception>
       </Docs>
     </Member>
     <Member MemberName="VerifyServerCertificate">