nerdbank-gitversioning 3.8.38-alpha → 3.8.118

package/nbgv.cli/tools/net8.0/any/Nerdbank.GitVersioning.xml

@@ -372,7 +372,7 @@
             No supported cloud build environment could be detected.
             </summary>
         </member>
-        <member name="M:Nerdbank.GitVersioning.Commands.CloudCommand.SetBuildVariables(System.String,System.Collections.Generic.IEnumerable{System.String},System.String,System.String,System.Boolean,System.Boolean,System.Collections.Generic.IEnumerable{System.Collections.Generic.KeyValuePair{System.String,System.String}},System.Boolean)">
+        <member name="M:Nerdbank.GitVersioning.Commands.CloudCommand.SetBuildVariables(System.String,System.Collections.Generic.IEnumerable{System.String},System.String,System.String,System.Boolean,System.Boolean,System.Boolean,System.Collections.Generic.IEnumerable{System.Collections.Generic.KeyValuePair{System.String,System.String}},System.Boolean)">
             <summary>
             Adds version variables to the the current cloud build environment.
             </summary>
@@ -395,6 +395,9 @@
             <param name="commonVars">
             Controls whether to define common version variables as cloud build variables.
             </param>
+            <param name="cloudBuildNumber">
+            Controls whether to emit the cloud build variable to set the build number.
+            </param>
             <param name="additionalVariables">
             Additional cloud build variables to define.
             </param>
@@ -1109,17 +1112,18 @@
             A sequence of possible filenames for the version file in preferred order.
             </summary>
         </member>
-        <member name="M:Nerdbank.GitVersioning.LibGit2.LibGit2VersionFile.GetVersion(LibGit2Sharp.Commit,System.String,System.Collections.Generic.Dictionary{LibGit2Sharp.ObjectId,Nerdbank.GitVersioning.VersionOptions},System.String@)">
+        <member name="M:Nerdbank.GitVersioning.LibGit2.LibGit2VersionFile.GetVersion(LibGit2Sharp.Commit,System.String,System.Collections.Generic.Dictionary{LibGit2Sharp.ObjectId,Nerdbank.GitVersioning.VersionOptions},Nerdbank.GitVersioning.VersionFileRequirements,Nerdbank.GitVersioning.VersionFileLocations@)">
             <summary>
             Reads the version.json file and returns the <see cref="T:Nerdbank.GitVersioning.VersionOptions"/> deserialized from it.
             </summary>
             <param name="commit">The commit to read from.</param>
             <param name="repoRelativeProjectDirectory">The directory to consider when searching for the version.txt file.</param>
             <param name="blobVersionCache">An optional blob cache for storing the raw parse results of a version.txt or version.json file (before any inherit merge operations are applied).</param>
-            <param name="actualDirectory">Receives the full path to the directory in which the version file was found.</param>
+            <param name="requirements"><inheritdoc cref="M:Nerdbank.GitVersioning.LibGit2.LibGit2VersionFile.GetVersionCore(Nerdbank.GitVersioning.VersionFileRequirements,Nerdbank.GitVersioning.VersionFileLocations@)" path="/param[@name='requirements']" /></param>
+            <param name="locations"><inheritdoc cref="M:Nerdbank.GitVersioning.LibGit2.LibGit2VersionFile.GetVersionCore(Nerdbank.GitVersioning.VersionFileRequirements,Nerdbank.GitVersioning.VersionFileLocations@)" path="/param[@name='locations']" /></param>
             <returns>The version information read from the file.</returns>
         </member>
-        <member name="M:Nerdbank.GitVersioning.LibGit2.LibGit2VersionFile.GetVersionCore(System.String@)">
+        <member name="M:Nerdbank.GitVersioning.LibGit2.LibGit2VersionFile.GetVersionCore(Nerdbank.GitVersioning.VersionFileRequirements,Nerdbank.GitVersioning.VersionFileLocations@)">
             <inheritdoc/>
         </member>
         <member name="T:Nerdbank.GitVersioning.ManagedGit.DeltaInstruction">
@@ -2327,6 +2331,26 @@
         <member name="M:Nerdbank.GitVersioning.ManagedGit.GitRepository.Dispose">
             <inheritdoc/>
         </member>
+        <member name="M:Nerdbank.GitVersioning.ManagedGit.GitRepository.TryReadIgnoreCaseFromConfigFile(System.String,System.Boolean@)">
+            <summary>
+            Attempts to read the core.ignorecase setting from a git config file.
+            </summary>
+            <param name="configPath">Path to the git config file.</param>
+            <param name="ignoreCase">The value of core.ignorecase if found.</param>
+            <returns>True if the setting was found and parsed successfully.</returns>
+        </member>
+        <member name="M:Nerdbank.GitVersioning.ManagedGit.GitRepository.GetGlobalConfigPath">
+            <summary>
+            Gets the path to the global git config file.
+            </summary>
+            <returns>The path to the global config file, or null if not found.</returns>
+        </member>
+        <member name="M:Nerdbank.GitVersioning.ManagedGit.GitRepository.ReadIgnoreCaseFromConfig">
+            <summary>
+            Reads the core.ignorecase setting from git configuration.
+            </summary>
+            <returns>True if case should be ignored, false otherwise.</returns>
+        </member>
         <member name="M:Nerdbank.GitVersioning.ManagedGit.GitRepository.EnumeratePackedRefsRaw(System.Boolean@)">
             <summary>
             Enumerate the lines in the packed-refs file. Skips comment lines.
@@ -2437,6 +2461,31 @@
             The <see cref="T:Nerdbank.GitVersioning.ManagedGit.GitObjectId"/> of the requested node.
             </returns>
         </member>
+        <member name="M:Nerdbank.GitVersioning.ManagedGit.GitTreeStreamingReader.FindNode(System.IO.Stream,System.ReadOnlySpan{System.Byte},System.Boolean)">
+            <summary>
+            Finds a specific node in a git tree.
+            </summary>
+            <param name="stream">
+            A <see cref="T:System.IO.Stream"/> which represents the git tree.
+            </param>
+            <param name="name">
+            The name of the node to find, in it UTF-8 representation.
+            </param>
+            <param name="ignoreCase">
+            Whether to ignore case when matching node names.
+            </param>
+            <returns>
+            The <see cref="T:Nerdbank.GitVersioning.ManagedGit.GitObjectId"/> of the requested node.
+            </returns>
+        </member>
+        <member name="M:Nerdbank.GitVersioning.ManagedGit.GitTreeStreamingReader.CompareIgnoreCase(System.ReadOnlySpan{System.Byte},System.ReadOnlySpan{System.Byte})">
+            <summary>
+            Compares two byte sequences case-insensitively (assuming UTF-8 encoding with ASCII characters).
+            </summary>
+            <param name="a">First byte sequence.</param>
+            <param name="b">Second byte sequence.</param>
+            <returns>True if the sequences are equal ignoring case.</returns>
+        </member>
         <member name="T:Nerdbank.GitVersioning.ManagedGit.MemoryMappedStream">
             <summary>
             Provides read-only, seekable access to a <see cref="T:System.IO.MemoryMappedFiles.MemoryMappedFile"/>.
@@ -2777,17 +2826,18 @@
             </summary>
             <param name="context"><inheritdoc /></param>
         </member>
-        <member name="M:Nerdbank.GitVersioning.Managed.ManagedVersionFile.GetVersion(Nerdbank.GitVersioning.ManagedGit.GitCommit,System.String,System.Collections.Generic.Dictionary{Nerdbank.GitVersioning.ManagedGit.GitObjectId,Nerdbank.GitVersioning.VersionOptions},System.String@)">
+        <member name="M:Nerdbank.GitVersioning.Managed.ManagedVersionFile.GetVersion(Nerdbank.GitVersioning.ManagedGit.GitCommit,System.String,System.Collections.Generic.Dictionary{Nerdbank.GitVersioning.ManagedGit.GitObjectId,Nerdbank.GitVersioning.VersionOptions},Nerdbank.GitVersioning.VersionFileRequirements,Nerdbank.GitVersioning.VersionFileLocations@)">
             <summary>
             Reads the version.json file and returns the <see cref="T:Nerdbank.GitVersioning.VersionOptions"/> deserialized from it.
             </summary>
             <param name="commit">The commit to read from.</param>
             <param name="repoRelativeProjectDirectory">The directory to consider when searching for the version.txt file.</param>
             <param name="blobVersionCache">An optional blob cache for storing the raw parse results of a version.txt or version.json file (before any inherit merge operations are applied).</param>
-            <param name="actualDirectory">Receives the full path to the directory in which the version file was found.</param>
+            <param name="requirements"><inheritdoc cref="M:Nerdbank.GitVersioning.Managed.ManagedVersionFile.GetVersionCore(Nerdbank.GitVersioning.VersionFileRequirements,Nerdbank.GitVersioning.VersionFileLocations@)" path="/param[@name='requirements']" /></param>
+            <param name="locations"><inheritdoc cref="M:Nerdbank.GitVersioning.Managed.ManagedVersionFile.GetVersionCore(Nerdbank.GitVersioning.VersionFileRequirements,Nerdbank.GitVersioning.VersionFileLocations@)" path="/param[@name='locations']" /></param>
             <returns>The version information read from the file.</returns>
         </member>
-        <member name="M:Nerdbank.GitVersioning.Managed.ManagedVersionFile.GetVersionCore(System.String@)">
+        <member name="M:Nerdbank.GitVersioning.Managed.ManagedVersionFile.GetVersionCore(Nerdbank.GitVersioning.VersionFileRequirements,Nerdbank.GitVersioning.VersionFileLocations@)">
             <inheritdoc/>
         </member>
         <member name="P:Nerdbank.GitVersioning.NoGitContext.VersionFile">
@@ -2826,7 +2876,7 @@
         <member name="M:Nerdbank.GitVersioning.NoGitContext.GetIdAsVersion(Nerdbank.GitVersioning.VersionOptions,Nerdbank.GitVersioning.VersionOptions,System.Int32)">
             <inheritdoc/>
         </member>
-        <member name="M:Nerdbank.GitVersioning.NoGitVersionFile.GetVersionCore(System.String@)">
+        <member name="M:Nerdbank.GitVersioning.NoGitVersionFile.GetVersionCore(Nerdbank.GitVersioning.VersionFileRequirements,Nerdbank.GitVersioning.VersionFileLocations@)">
             <inheritdoc/>
         </member>
         <member name="T:Nerdbank.GitVersioning.ReleaseManager">
@@ -3309,20 +3359,27 @@
             Gets the git context to use when reading version files.
             </summary>
         </member>
+        <member name="P:Nerdbank.GitVersioning.VersionFile.VersionSearchRootToBranch">
+            <summary>
+            Gets a value indicating whether merging paths with <see cref="M:Nerdbank.GitVersioning.VersionFile.MergeLocations(Nerdbank.GitVersioning.VersionFileLocations@,Nerdbank.GitVersioning.VersionFileLocations)"/> and <see cref="M:Nerdbank.GitVersioning.VersionFile.ApplyLocations(Nerdbank.GitVersioning.VersionOptions,System.String,Nerdbank.GitVersioning.VersionFileLocations@)"/>
+            prefer the new locations over the old ones.
+            </summary>
+        </member>
         <member name="M:Nerdbank.GitVersioning.VersionFile.IsVersionDefined">
             <summary>
             Checks whether a version file is defined.
             </summary>
             <returns><see langword="true"/> if the version file is found; otherwise <see langword="false"/>.</returns>
         </member>
-        <member name="M:Nerdbank.GitVersioning.VersionFile.GetWorkingCopyVersion">
-            <inheritdoc cref="M:Nerdbank.GitVersioning.VersionFile.GetWorkingCopyVersion(System.String@)"/>
+        <member name="M:Nerdbank.GitVersioning.VersionFile.GetWorkingCopyVersion(Nerdbank.GitVersioning.VersionFileRequirements)">
+            <inheritdoc cref="M:Nerdbank.GitVersioning.VersionFile.GetWorkingCopyVersion(Nerdbank.GitVersioning.VersionFileRequirements,Nerdbank.GitVersioning.VersionFileLocations@)"/>
         </member>
-        <member name="M:Nerdbank.GitVersioning.VersionFile.GetWorkingCopyVersion(System.String@)">
+        <member name="M:Nerdbank.GitVersioning.VersionFile.GetWorkingCopyVersion(Nerdbank.GitVersioning.VersionFileRequirements,Nerdbank.GitVersioning.VersionFileLocations@)">
             <summary>
             Reads the version file from the working tree and returns the <see cref="T:Nerdbank.GitVersioning.VersionOptions"/> deserialized from it.
             </summary>
-            <param name="actualDirectory">Set to the actual directory that the version file was found in, which may be <see cref="P:Nerdbank.GitVersioning.GitContext.WorkingTreePath"/> or one of its ancestors.</param>
+            <param name="requirements"><inheritdoc cref="M:Nerdbank.GitVersioning.VersionFile.GetVersionCore(Nerdbank.GitVersioning.VersionFileRequirements,Nerdbank.GitVersioning.VersionFileLocations@)" path="/param[@name='requirements']" /></param>
+            <param name="locations"><inheritdoc cref="M:Nerdbank.GitVersioning.VersionFile.GetVersionCore(Nerdbank.GitVersioning.VersionFileRequirements,Nerdbank.GitVersioning.VersionFileLocations@)" path="/param[@name='locations']" /></param>
             <returns>The version information read from the file, or <see langword="null"/> if the file wasn't found.</returns>
         </member>
         <member name="M:Nerdbank.GitVersioning.VersionFile.SetVersion(System.String,System.Version,System.String,System.Boolean)">
@@ -3343,18 +3400,19 @@
             <returns>The path to the file written.</returns>
         </member>
         <member name="M:Nerdbank.GitVersioning.VersionFile.GetVersion">
-            <inheritdoc cref="M:Nerdbank.GitVersioning.VersionFile.GetVersion(System.String@)"/>
+            <inheritdoc cref="M:Nerdbank.GitVersioning.VersionFile.GetVersion(Nerdbank.GitVersioning.VersionFileRequirements,Nerdbank.GitVersioning.VersionFileLocations@)"/>
         </member>
-        <member name="M:Nerdbank.GitVersioning.VersionFile.GetVersion(System.String@)">
+        <member name="M:Nerdbank.GitVersioning.VersionFile.GetVersion(Nerdbank.GitVersioning.VersionFileRequirements,Nerdbank.GitVersioning.VersionFileLocations@)">
             <summary>
             Reads the version file from the selected git commit (or working copy if no commit is selected) and returns the <see cref="T:Nerdbank.GitVersioning.VersionOptions"/> deserialized from it.
             </summary>
-            <param name="actualDirectory">Receives the absolute path to the directory where the version file was found, if any.</param>
+            <param name="requirements"><inheritdoc cref="M:Nerdbank.GitVersioning.VersionFile.GetVersionCore(Nerdbank.GitVersioning.VersionFileRequirements,Nerdbank.GitVersioning.VersionFileLocations@)" path="/param[@name='requirements']" /></param>
+            <param name="locations"><inheritdoc cref="M:Nerdbank.GitVersioning.VersionFile.GetVersionCore(Nerdbank.GitVersioning.VersionFileRequirements,Nerdbank.GitVersioning.VersionFileLocations@)" path="/param[@name='locations']" /></param>
             <returns>The version information read from the file, or <see langword="null"/> if the file wasn't found.</returns>
         </member>
         <member name="M:Nerdbank.GitVersioning.VersionFile.TryReadVersionJsonContent(System.String,System.String)">
             <summary>
-            Tries to read a version.json file from the specified string, but favors returning null instead of throwing a <see cref="T:Newtonsoft.Json.JsonSerializationException"/>.
+            Tries to read a version.json file from the specified string, but favors returning null instead of throwing a <see cref="T:Newtonsoft.Json.JsonException"/>.
             </summary>
             <param name="jsonContent">The content of the version.json file.</param>
             <param name="repoRelativeBaseDirectory">Directory that this version.json file is relative to the root of the repository.</param>
@@ -3367,22 +3425,56 @@
             <param name="versionTextContent">The content of the version.txt file to read.</param>
             <returns>The version information read from the file; or <see langword="null"/> if a deserialization error occurs.</returns>
         </member>
-        <member name="M:Nerdbank.GitVersioning.VersionFile.GetVersionCore(System.String@)">
+        <member name="M:Nerdbank.GitVersioning.VersionFile.GetVersionCore(Nerdbank.GitVersioning.VersionFileRequirements,Nerdbank.GitVersioning.VersionFileLocations@)">
             <summary>
             Reads the version file from <see cref="P:Nerdbank.GitVersioning.GitContext.GitCommitId"/> in the <see cref="P:Nerdbank.GitVersioning.VersionFile.Context"/> and returns the <see cref="T:Nerdbank.GitVersioning.VersionOptions"/> deserialized from it.
             </summary>
-            <param name="actualDirectory">Receives the absolute path to the directory where the version file was found, if any.</param>
+            <param name="requirements"><inheritdoc cref="M:Nerdbank.GitVersioning.VersionFile.GetVersionCore(Nerdbank.GitVersioning.VersionFileRequirements,Nerdbank.GitVersioning.VersionFileLocations@)" path="/param[@name='requirements']" /></param>
+            <param name="locations"><inheritdoc cref="M:Nerdbank.GitVersioning.VersionFile.GetVersionCore(Nerdbank.GitVersioning.VersionFileRequirements,Nerdbank.GitVersioning.VersionFileLocations@)" path="/param[@name='locations']" /></param>
             <returns>The version information read from the file, or <see langword="null"/> if the file wasn't found.</returns>
             <remarks>This method is only called if <see cref="P:Nerdbank.GitVersioning.GitContext.GitCommitId"/> is not null.</remarks>
         </member>
-        <member name="M:Nerdbank.GitVersioning.VersionFile.GetWorkingCopyVersion(System.String,System.String@)">
+        <member name="M:Nerdbank.GitVersioning.VersionFile.GetWorkingCopyVersion(System.String,Nerdbank.GitVersioning.VersionFileRequirements,Nerdbank.GitVersioning.VersionFileLocations@)">
             <summary>
             Reads a version file from the working tree, without any regard to a git repo.
             </summary>
             <param name="startingDirectory">The path to start the search from.</param>
-            <param name="actualDirectory">Receives the directory where the version file was found.</param>
+            <param name="requirements"><inheritdoc cref="M:Nerdbank.GitVersioning.VersionFile.GetVersionCore(Nerdbank.GitVersioning.VersionFileRequirements,Nerdbank.GitVersioning.VersionFileLocations@)" path="/param[@name='requirements']" /></param>
+            <param name="locations"><inheritdoc cref="M:Nerdbank.GitVersioning.VersionFile.GetVersionCore(Nerdbank.GitVersioning.VersionFileRequirements,Nerdbank.GitVersioning.VersionFileLocations@)" path="/param[@name='locations']" /></param>
             <returns>The version options, if found.</returns>
         </member>
+        <member name="T:Nerdbank.GitVersioning.VersionFileLocations">
+            <summary>
+            Describes locations of version files found during a search.
+            </summary>
+        </member>
+        <member name="P:Nerdbank.GitVersioning.VersionFileLocations.NonInheritingVersionDirectory">
+            <summary>Gets or sets the absolute path to the directory where the first non-inheriting version file was found, if any.</summary>
+        </member>
+        <member name="P:Nerdbank.GitVersioning.VersionFileLocations.VersionSpecifyingVersionDirectory">
+            <summary>Gets or sets the absolute path to the directory where the first version.json file with an actual version property set was found, if any.</summary>
+        </member>
+        <member name="F:Nerdbank.GitVersioning.VersionFileRequirements.Default">
+            <summary>
+            No flags. Default behavior.
+            </summary>
+        </member>
+        <member name="F:Nerdbank.GitVersioning.VersionFileRequirements.NonMergedResult">
+            <summary>
+            We want a version options object initialized with <em>only</em> one version.json file (the one that matches other requirements),
+            rather than the merge the result of all relevant version.json files.
+            </summary>
+        </member>
+        <member name="F:Nerdbank.GitVersioning.VersionFileRequirements.VersionSpecified">
+            <summary>
+            We require a version.json file that specifies a version (i.e. has a "version" property).
+            </summary>
+        </member>
+        <member name="F:Nerdbank.GitVersioning.VersionFileRequirements.AcceptInheritingFile">
+            <summary>
+            Stop search at the first version.json found, even if it inherits from another.
+            </summary>
+        </member>
         <member name="T:Nerdbank.GitVersioning.VersionOptions">
             <summary>
             Describes the various versions and options required for the build.
@@ -3547,6 +3639,7 @@
         <member name="F:Nerdbank.GitVersioning.VersionOptions.CloudBuildNumberCommitWhere.FourthVersionComponent">
             <summary>
             The commit ID appears as the 4th integer in the version (e.g. 1.2.3.23523).
+            Specifically, the first 15 bits of the commit hash are used as the 4th integer.
             </summary>
         </member>
         <member name="T:Nerdbank.GitVersioning.VersionOptions.ReleaseVersionIncrement">
@@ -4705,7 +4798,7 @@
         <member name="F:Windows.Win32.Foundation.HANDLE.INVALID_HANDLE_VALUE">
             <summary>There is no interactive user. The trust provider performs the verification action without the user's assistance.</summary>
             <remarks>
-            <para><see href="https://docs.microsoft.com/windows/win32/api//wintrust/nf-wintrust-winverifytrust">Learn more about this API from docs.microsoft.com</see>.</para>
+            <para><see href="https://learn.microsoft.com/windows/win32/api/wintrust/nf-wintrust-winverifytrust">Learn more about this API from docs.microsoft.com</see>.</para>
             </remarks>
         </member>
         <member name="T:Windows.Win32.Foundation.PCWSTR">
@@ -4736,7 +4829,7 @@
         </member>
         <member name="T:Windows.Win32.FreeLibrarySafeHandle">
             <summary>
-            Represents a Win32 handle that can be closed with <see cref="M:Windows.Win32.PInvoke.FreeLibrary(Windows.Win32.Foundation.HINSTANCE)"/>.
+            Represents a Win32 handle that can be closed with <see cref="M:Windows.Win32.PInvoke.FreeLibrary(Windows.Win32.Foundation.HMODULE)"/>.
             </summary>
         </member>
         <member name="T:Windows.Win32.PInvoke">
@@ -4748,87 +4841,91 @@
             <summary>Closes an open object handle.</summary>
             <param name="hObject">A valid handle to an open object.</param>
             <returns>
-            <para>If the function succeeds, the return value is nonzero. If the function fails, the return value is zero. To get extended error information, call <a href="/windows/desktop/api/errhandlingapi/nf-errhandlingapi-getlasterror">GetLastError</a>. If the application is running under a debugger,  the function will throw an exception if it receives either a  handle value that is not valid  or a pseudo-handle value. This can happen if you close a handle twice, or if you  call <b>CloseHandle</b> on a handle returned by the <a href="/windows/desktop/api/fileapi/nf-fileapi-findfirstfilea">FindFirstFile</a> function instead of calling the <a href="/windows/desktop/api/fileapi/nf-fileapi-findclose">FindClose</a> function.</para>
+            <para>If the function succeeds, the return value is nonzero. If the function fails, the return value is zero. To get extended error information, call <a href="https://docs.microsoft.com/windows/desktop/api/errhandlingapi/nf-errhandlingapi-getlasterror">GetLastError</a>. If the application is running under a debugger,  the function will throw an exception if it receives either a  handle value that is not valid  or a pseudo-handle value. This can happen if you close a handle twice, or if you  call <b>CloseHandle</b> on a handle returned by the <a href="https://docs.microsoft.com/windows/desktop/api/fileapi/nf-fileapi-findfirstfilea">FindFirstFile</a> function instead of calling the <a href="https://docs.microsoft.com/windows/desktop/api/fileapi/nf-fileapi-findclose">FindClose</a> function.</para>
             </returns>
             <remarks>
-            <para><see href="https://docs.microsoft.com/windows/win32/api//handleapi/nf-handleapi-closehandle">Learn more about this API from docs.microsoft.com</see>.</para>
+            <para>The <b>CloseHandle</b> function closes handles to the following objects: </para>
+            <para>This doc was truncated.</para>
+            <para><see href="https://learn.microsoft.com/windows/win32/api/handleapi/nf-handleapi-closehandle#">Read more on docs.microsoft.com</see>.</para>
             </remarks>
         </member>
         <member name="M:Windows.Win32.PInvoke.CreateFile(System.String,System.UInt32,Windows.Win32.Storage.FileSystem.FILE_SHARE_MODE,System.Nullable{Windows.Win32.Security.SECURITY_ATTRIBUTES},Windows.Win32.Storage.FileSystem.FILE_CREATION_DISPOSITION,Windows.Win32.Storage.FileSystem.FILE_FLAGS_AND_ATTRIBUTES,System.Runtime.InteropServices.SafeHandle)">
             <inheritdoc cref="M:Windows.Win32.PInvoke.CreateFile(Windows.Win32.Foundation.PCWSTR,System.UInt32,Windows.Win32.Storage.FileSystem.FILE_SHARE_MODE,Windows.Win32.Security.SECURITY_ATTRIBUTES*,Windows.Win32.Storage.FileSystem.FILE_CREATION_DISPOSITION,Windows.Win32.Storage.FileSystem.FILE_FLAGS_AND_ATTRIBUTES,Windows.Win32.Foundation.HANDLE)"/>
         </member>
         <member name="M:Windows.Win32.PInvoke.CreateFile(Windows.Win32.Foundation.PCWSTR,System.UInt32,Windows.Win32.Storage.FileSystem.FILE_SHARE_MODE,Windows.Win32.Security.SECURITY_ATTRIBUTES*,Windows.Win32.Storage.FileSystem.FILE_CREATION_DISPOSITION,Windows.Win32.Storage.FileSystem.FILE_FLAGS_AND_ATTRIBUTES,Windows.Win32.Foundation.HANDLE)">
-            <summary>Creates or opens a file or I/O device. The most commonly used I/O devices are as follows:\_file, file stream, directory, physical disk, volume, console buffer, tape drive, communications resource, mailslot, and pipe.</summary>
+            <summary>Creates or opens a file or I/O device. The most commonly used I/O devices are as follows:\_file, file stream, directory, physical disk, volume, console buffer, tape drive, communications resource, mailslot, and pipe. (Unicode)</summary>
             <param name="lpFileName">
             <para>The name of the file or device to be created or opened. You may use either forward slashes (/) or backslashes (\\) in this name. In the ANSI version of this function, the name is limited to <b>MAX_PATH</b> characters. To extend this limit to 32,767 wide characters, use this Unicode version of the function and prepend "\\\\?\\" to the path. For more information, see <a href="https://docs.microsoft.com/windows/desktop/FileIO/naming-a-file">Naming Files, Paths, and Namespaces</a>. For information on special device names, see <a href="https://docs.microsoft.com/windows/desktop/FileIO/defining-an-ms-dos-device-name">Defining an MS-DOS Device Name</a>. To create a file stream, specify the name of the file, a colon, and then the name of the stream. For more information, see <a href="https://docs.microsoft.com/windows/desktop/FileIO/file-streams">File Streams</a>. <div class="alert"><b>Tip</b>  Starting with Windows 10, version 1607, for the unicode version of this function (<b>CreateFileW</b>), you can opt-in to remove the <b>MAX_PATH</b> limitation without prepending "\\?\". See the "Maximum Path Length Limitation" section of <a href="https://docs.microsoft.com/windows/desktop/FileIO/naming-a-file">Naming Files, Paths, and Namespaces</a> for details.</div> <div> </div></para>
-            <para><see href="https://docs.microsoft.com/windows/win32/api//fileapi/nf-fileapi-createfilew#parameters">Read more on docs.microsoft.com</see>.</para>
+            <para><see href="https://learn.microsoft.com/windows/win32/api/fileapi/nf-fileapi-createfilew#parameters">Read more on docs.microsoft.com</see>.</para>
             </param>
             <param name="dwDesiredAccess">
             <para>The requested access to the file or device, which can be summarized as read, write, both or neither zero). The most commonly used values are <b>GENERIC_READ</b>, <b>GENERIC_WRITE</b>, or both (<c>GENERIC_READ | GENERIC_WRITE</c>). For more information, see <a href="https://docs.microsoft.com/windows/desktop/SecAuthZ/generic-access-rights">Generic Access Rights</a>, <a href="https://docs.microsoft.com/windows/desktop/FileIO/file-security-and-access-rights">File Security and Access Rights</a>, <a href="https://docs.microsoft.com/windows/desktop/FileIO/file-access-rights-constants">File Access Rights Constants</a>, and <a href="https://docs.microsoft.com/windows/desktop/SecAuthZ/access-mask">ACCESS_MASK</a>. If this parameter is zero, the application can query certain metadata such as file, directory, or device attributes without accessing that file or device, even if <b>GENERIC_READ</b> access would have been denied. You cannot request an access mode that conflicts with the sharing mode that is specified by the <i>dwShareMode</i> parameter in an open request that already has an open handle. For more information, see the Remarks section of this topic and <a href="https://docs.microsoft.com/windows/desktop/FileIO/creating-and-opening-files">Creating and Opening Files</a>.</para>
-            <para><see href="https://docs.microsoft.com/windows/win32/api//fileapi/nf-fileapi-createfilew#parameters">Read more on docs.microsoft.com</see>.</para>
+            <para><see href="https://learn.microsoft.com/windows/win32/api/fileapi/nf-fileapi-createfilew#parameters">Read more on docs.microsoft.com</see>.</para>
             </param>
             <param name="dwShareMode">
             <para>The requested sharing mode of the file or device, which can be read, write, both, delete, all of these, or none (refer to the following table). Access requests to attributes or extended attributes are not affected by this flag. If this parameter is zero and <b>CreateFile</b> succeeds, the file or device cannot be shared and cannot be opened again until the handle to the file or device is closed. For more information, see the Remarks section. You cannot request a sharing mode that conflicts with the access mode that is specified in an existing request that has an open handle. <b>CreateFile</b> would fail and the <a href="https://docs.microsoft.com/windows/desktop/api/errhandlingapi/nf-errhandlingapi-getlasterror">GetLastError</a> function would return <b>ERROR_SHARING_VIOLATION</b>. To enable a process to share a file or device while another process has the file or device open, use a</para>
-            <para><see href="https://docs.microsoft.com/windows/win32/api//fileapi/nf-fileapi-createfilew#parameters">Read more on docs.microsoft.com</see>.</para>
+            <para><see href="https://learn.microsoft.com/windows/win32/api/fileapi/nf-fileapi-createfilew#parameters">Read more on docs.microsoft.com</see>.</para>
             </param>
             <param name="lpSecurityAttributes">
-            <para>A pointer to a <a href="https://docs.microsoft.com/previous-versions/windows/desktop/legacy/aa379560(v=vs.85)">SECURITY_ATTRIBUTES</a> structure that contains two separate but related data members: an optional security descriptor, and a Boolean value that determines whether the returned handle can be inherited by child processes. This parameter can be <b>NULL</b>. If this parameter is <b>NULL</b>, the handle returned by <b>CreateFile</b> cannot be inherited by any child processes the application may create and the file or device associated with the returned handle gets a default security descriptor. The <b>lpSecurityDescriptor</b> member of the structure specifies a <a href="https://docs.microsoft.com/windows/desktop/api/winnt/ns-winnt-security_descriptor">SECURITY_DESCRIPTOR</a> for a file or device. If this member is <b>NULL</b>, the file or device associated with the returned handle is assigned a default security descriptor. <b>CreateFile</b> ignores the <b>lpSecurityDescriptor</b> member when opening an existing file or device, but continues to use the <b>bInheritHandle</b> member. The <b>bInheritHandle</b>member of the structure specifies whether the returned handle can be inherited. For more information, see the Remarks section.</para>
-            <para><see href="https://docs.microsoft.com/windows/win32/api//fileapi/nf-fileapi-createfilew#parameters">Read more on docs.microsoft.com</see>.</para>
+            <para>A pointer to a <a href="https://docs.microsoft.com/previous-versions/windows/desktop/legacy/aa379560(v=vs.85)">SECURITY_ATTRIBUTES</a> structure that contains two separate but related data members: an optional security descriptor, and a Boolean value that determines whether the returned handle can be inherited by child processes. This parameter can be <b>NULL</b>. If this parameter is <b>NULL</b>, the handle returned by <b>CreateFile</b> cannot be inherited by any child processes the application may create and the file or device associated with the returned handle gets a default security descriptor. The <b>lpSecurityDescriptor</b> member of the structure specifies a <a href="https://docs.microsoft.com/windows/desktop/api/winnt/ns-winnt-security_descriptor">SECURITY_DESCRIPTOR</a> for a file or device. If this member is <b>NULL</b>, the file or device associated with the returned handle is assigned a default security descriptor. <b>CreateFile</b> ignores the <b>lpSecurityDescriptor</b> member when opening an existing file or device, but continues to use the <b>bInheritHandle</b> member. The <b>bInheritHandle</b> member of the structure specifies whether the returned handle can be inherited. For more information, see the Remarks section.</para>
+            <para><see href="https://learn.microsoft.com/windows/win32/api/fileapi/nf-fileapi-createfilew#parameters">Read more on docs.microsoft.com</see>.</para>
             </param>
             <param name="dwCreationDisposition">
             <para>An action to take on a file or device that exists or does not exist. For devices other than files, this parameter is usually set to <b>OPEN_EXISTING</b>. For more information, see the Remarks section.</para>
-            <para><see href="https://docs.microsoft.com/windows/win32/api//fileapi/nf-fileapi-createfilew#parameters">Read more on docs.microsoft.com</see>.</para>
+            <para><see href="https://learn.microsoft.com/windows/win32/api/fileapi/nf-fileapi-createfilew#parameters">Read more on docs.microsoft.com</see>.</para>
             </param>
             <param name="dwFlagsAndAttributes">
             <para>The file or device attributes and flags, <b>FILE_ATTRIBUTE_NORMAL</b> being the most common default value for files. This parameter can include any combination of the available file attributes (<b>FILE_ATTRIBUTE_*</b>). All other file attributes override <b>FILE_ATTRIBUTE_NORMAL</b>. This parameter can also contain combinations of flags (<b>FILE_FLAG_*</b>) for control of file or device caching behavior, access modes, and other special-purpose flags. These combine with any <b>FILE_ATTRIBUTE_*</b> values. This parameter can also contain Security Quality of Service (SQOS) information by specifying the <b>SECURITY_SQOS_PRESENT</b> flag. Additional SQOS-related flags information is presented in the table following the attributes and flags tables. <div class="alert"><b>Note</b>  When <b>CreateFile</b> opens an existing file, it generally combines the file flags with the file attributes of the existing file, and ignores any file attributes supplied as part of <i>dwFlagsAndAttributes</i>. Special cases are detailed in <a href="https://docs.microsoft.com/windows/desktop/FileIO/creating-and-opening-files">Creating and Opening Files</a>.</div> <div> </div> Some of the following file attributes and flags may only apply to files and not necessarily all other types of devices that <b>CreateFile</b> can open. For additional information, see the Remarks section of this topic and <a href="https://docs.microsoft.com/windows/desktop/FileIO/creating-and-opening-files">Creating and Opening Files</a>. For more advanced access to file attributes, see <a href="https://docs.microsoft.com/windows/desktop/api/fileapi/nf-fileapi-setfileattributesa">SetFileAttributes</a>. For a complete list of all file attributes with their values and descriptions, see <a href="https://docs.microsoft.com/windows/desktop/FileIO/file-attribute-constants">File Attribute Constants</a>. </para>
             <para>This doc was truncated.</para>
-            <para><see href="https://docs.microsoft.com/windows/win32/api//fileapi/nf-fileapi-createfilew#parameters">Read more on docs.microsoft.com</see>.</para>
+            <para><see href="https://learn.microsoft.com/windows/win32/api/fileapi/nf-fileapi-createfilew#parameters">Read more on docs.microsoft.com</see>.</para>
             </param>
             <param name="hTemplateFile">
             <para>A valid handle to a template file with the <b>GENERIC_READ</b> access right. The template file supplies file attributes and extended attributes for the file that is being created. This parameter can be <b>NULL</b>. When opening an existing file, <b>CreateFile</b> ignores this parameter. When opening a new encrypted file, the file inherits the discretionary access control list from its parent directory. For additional information, see <a href="https://docs.microsoft.com/windows/desktop/FileIO/file-encryption">File Encryption</a>.</para>
-            <para><see href="https://docs.microsoft.com/windows/win32/api//fileapi/nf-fileapi-createfilew#parameters">Read more on docs.microsoft.com</see>.</para>
+            <para><see href="https://learn.microsoft.com/windows/win32/api/fileapi/nf-fileapi-createfilew#parameters">Read more on docs.microsoft.com</see>.</para>
             </param>
             <returns>
-            <para>If the function succeeds, the return value is an open handle to the specified file, device, named pipe, or mail slot. If the function fails, the return value is <b>INVALID_HANDLE_VALUE</b>. To get extended error information, call <a href="/windows/desktop/api/errhandlingapi/nf-errhandlingapi-getlasterror">GetLastError</a>.</para>
+            <para>If the function succeeds, the return value is an open handle to the specified file, device, named pipe, or mail slot. If the function fails, the return value is <b>INVALID_HANDLE_VALUE</b>. To get extended error information, call <a href="https://docs.microsoft.com/windows/desktop/api/errhandlingapi/nf-errhandlingapi-getlasterror">GetLastError</a>.</para>
             </returns>
             <remarks>
-            <para><see href="https://docs.microsoft.com/windows/win32/api//fileapi/nf-fileapi-createfilew">Learn more about this API from docs.microsoft.com</see>.</para>
+            <para><b>CreateFile</b> was originally developed specifically for file interaction but has since been expanded and enhanced to include most other types of I/O devices and mechanisms available to Windows developers. This section attempts to cover the varied issues developers may experience when using <b>CreateFile</b> in different contexts and with different I/O types. The text attempts to use the word <i>file</i> only when referring specifically to data stored in an actual file on a file system. However, some uses of <i>file</i> may be referring more generally to an I/O object that supports file-like mechanisms. This liberal use of the term <i>file</i> is particularly prevalent in constant names and parameter names because of the previously mentioned historical reasons. When an application is finished using the object handle returned by <b>CreateFile</b>, use the <a href="https://docs.microsoft.com/windows/desktop/api/handleapi/nf-handleapi-closehandle">CloseHandle</a> function to close the handle. This not only frees up system resources, but can have wider influence on things like sharing the file or device and committing data to disk. Specifics are noted within this topic as appropriate. <b>Windows Server 2003 and Windows XP:  </b>A sharing violation occurs if an attempt is made to open a file or directory for deletion on a remote computer when the value of the <i>dwDesiredAccess</i> parameter is the <b>DELETE</b> access flag (0x00010000) <b>OR</b>'ed with any other access flag, and the remote file or directory has not been opened with <b>FILE_SHARE_DELETE</b>. To avoid the sharing violation in this scenario, open the remote file or directory with the <b>DELETE</b> access right only, or call <a href="https://docs.microsoft.com/windows/desktop/api/fileapi/nf-fileapi-deletefilea">DeleteFile</a> without first opening the file or directory for deletion. Some file systems, such as the NTFS file system, support compression or encryption for individual files and directories. On volumes that have a mounted file system with this support, a new file inherits the compression and encryption attributes of its directory. You cannot use <b>CreateFile</b> to control compression, decompression, or decryption on a file or directory. For more information, see <a href="https://docs.microsoft.com/windows/desktop/FileIO/creating-and-opening-files">Creating and Opening Files</a>, <a href="https://docs.microsoft.com/windows/desktop/FileIO/file-compression-and-decompression">File Compression and Decompression</a>, and <a href="https://docs.microsoft.com/windows/desktop/FileIO/file-encryption">File Encryption</a>. <b>Windows Server 2003 and Windows XP:  </b>For backward compatibility purposes, <b>CreateFile</b> does not apply inheritance rules when you specify a security descriptor in <i>lpSecurityAttributes</i>. To support inheritance, functions that later query the security descriptor of this file may heuristically determine and report that inheritance is in effect. For more information, see <a href="https://docs.microsoft.com/windows/desktop/SecAuthZ/automatic-propagation-of-inheritable-aces">Automatic Propagation of Inheritable ACEs</a>. As stated previously, if the <i>lpSecurityAttributes</i> parameter is <b>NULL</b>, the handle returned by <b>CreateFile</b> cannot be inherited by any child processes your application may create. The following information regarding this parameter also applies: </para>
+            <para>This doc was truncated.</para>
+            <para><see href="https://learn.microsoft.com/windows/win32/api/fileapi/nf-fileapi-createfilew#">Read more on docs.microsoft.com</see>.</para>
             </remarks>
         </member>
-        <member name="M:Windows.Win32.PInvoke.FreeLibrary(Windows.Win32.Foundation.HINSTANCE)">
+        <member name="M:Windows.Win32.PInvoke.FreeLibrary(Windows.Win32.Foundation.HMODULE)">
             <summary>Frees the loaded dynamic-link library (DLL) module and, if necessary, decrements its reference count.</summary>
             <param name="hLibModule">
             <para>A handle to the loaded library module. The <a href="https://docs.microsoft.com/windows/desktop/api/libloaderapi/nf-libloaderapi-loadlibrarya">LoadLibrary</a>, <a href="https://docs.microsoft.com/windows/desktop/api/libloaderapi/nf-libloaderapi-loadlibraryexa">LoadLibraryEx</a>, <a href="https://docs.microsoft.com/windows/desktop/api/libloaderapi/nf-libloaderapi-getmodulehandlea">GetModuleHandle</a>, or <a href="https://docs.microsoft.com/windows/desktop/api/libloaderapi/nf-libloaderapi-getmodulehandleexa">GetModuleHandleEx</a> function returns this handle.</para>
-            <para><see href="https://docs.microsoft.com/windows/win32/api//libloaderapi/nf-libloaderapi-freelibrary#parameters">Read more on docs.microsoft.com</see>.</para>
+            <para><see href="https://learn.microsoft.com/windows/win32/api/libloaderapi/nf-libloaderapi-freelibrary#parameters">Read more on docs.microsoft.com</see>.</para>
             </param>
             <returns>
-            <para>If the function succeeds, the return value is nonzero. If the function fails, the return value is zero. To get extended error information, call the <a href="/windows/desktop/api/errhandlingapi/nf-errhandlingapi-getlasterror">GetLastError</a> function.</para>
+            <para>If the function succeeds, the return value is nonzero. If the function fails, the return value is zero. To get extended error information, call the <a href="https://docs.microsoft.com/windows/desktop/api/errhandlingapi/nf-errhandlingapi-getlasterror">GetLastError</a> function.</para>
             </returns>
             <remarks>
-            <para><see href="https://docs.microsoft.com/windows/win32/api//libloaderapi/nf-libloaderapi-freelibrary">Learn more about this API from docs.microsoft.com</see>.</para>
+            <para>The system maintains a per-process reference count for each loaded module. A  module that was loaded at process initialization due to load-time dynamic linking has a reference count of one. The reference count for a module is incremented each time the  module is loaded by a call to <a href="https://docs.microsoft.com/windows/desktop/api/libloaderapi/nf-libloaderapi-loadlibrarya">LoadLibrary</a>. The reference count is also incremented by a call to <a href="https://docs.microsoft.com/windows/desktop/api/libloaderapi/nf-libloaderapi-loadlibraryexa">LoadLibraryEx</a> unless the  module  is being loaded for the first time and is being loaded as   a data or image file. The reference count is decremented each time the <b>FreeLibrary</b> or <a href="https://docs.microsoft.com/windows/desktop/api/libloaderapi/nf-libloaderapi-freelibraryandexitthread">FreeLibraryAndExitThread</a> function is called for the module. When a  module's reference count reaches zero or the process terminates, the system unloads the module from the address space of the  process. Before unloading a library module, the system enables the module to detach from the process by calling the module's <a href="https://docs.microsoft.com/windows/desktop/Dlls/dllmain">DllMain</a> function, if it has one, with the DLL_PROCESS_DETACH value. Doing so gives the library module an opportunity to clean up resources allocated on behalf of the current process. After the entry-point function returns, the library module is removed from the address space of the current process. It is not safe to call <b>FreeLibrary</b> from <a href="https://docs.microsoft.com/windows/desktop/Dlls/dllmain">DllMain</a>. For more information, see the Remarks section in <a href="https://docs.microsoft.com/windows/desktop/Dlls/dllmain">DllMain</a>. Calling <b>FreeLibrary</b> does not affect other processes that are using the same module. Use caution when calling <b>FreeLibrary</b> with a handle returned by <a href="https://docs.microsoft.com/windows/desktop/api/libloaderapi/nf-libloaderapi-getmodulehandlea">GetModuleHandle</a>. The <b>GetModuleHandle</b> function does not increment a module's reference count, so passing this handle to <b>FreeLibrary</b> can cause a module to be unloaded prematurely. A thread that must unload the DLL in which it is executing and then terminate itself should call <a href="https://docs.microsoft.com/windows/desktop/api/libloaderapi/nf-libloaderapi-freelibraryandexitthread">FreeLibraryAndExitThread</a> instead of calling <b>FreeLibrary</b> and <b>ExitThread</b> separately. Otherwise, a race condition can occur. For details, see the Remarks section of <a href="https://docs.microsoft.com/windows/desktop/api/libloaderapi/nf-libloaderapi-freelibraryandexitthread">FreeLibraryAndExitThread</a>.</para>
+            <para><see href="https://learn.microsoft.com/windows/win32/api/libloaderapi/nf-libloaderapi-freelibrary#">Read more on docs.microsoft.com</see>.</para>
             </remarks>
         </member>
         <member name="M:Windows.Win32.PInvoke.LoadLibrary(System.String)">
             <inheritdoc cref="M:Windows.Win32.PInvoke.LoadLibrary(Windows.Win32.Foundation.PCWSTR)"/>
         </member>
         <member name="M:Windows.Win32.PInvoke.LoadLibrary(Windows.Win32.Foundation.PCWSTR)">
-            <summary>Loads the specified module into the address space of the calling process.</summary>
+            <summary>Loads the specified module into the address space of the calling process. (LoadLibraryW)</summary>
             <param name="lpLibFileName">
-            <para>The name of the module. This can be either a library module (a .dll file) or an executable module (an .exe file). The name specified is the file name of the module and is not related to the name stored in the library module itself, as specified by the <b>LIBRARY</b> keyword in the module-definition (.def) file. If the string specifies a full path, the function searches only that path for the module. If the string specifies a relative path or a module name without a path, the function uses a standard search strategy to find the module; for more information, see the Remarks. If the function cannot find the  module, the function fails. When specifying a path, be sure to use backslashes (\\), not forward slashes (/). For more information about paths, see <a href="https://docs.microsoft.com/windows/desktop/FileIO/naming-a-file">Naming a File or Directory</a>. If the string specifies a module name without a path and the file name extension is omitted, the function appends the default library extension .dll to the module name. To prevent the function from appending .dll to the module name, include a trailing point character (.) in the module name string.</para>
-            <para><see href="https://docs.microsoft.com/windows/win32/api//libloaderapi/nf-libloaderapi-loadlibraryw#parameters">Read more on docs.microsoft.com</see>.</para>
+            <para>The name of the module. This can be either a library module (a .dll file) or an executable module (an .exe file). If the specified module is an executable module, static imports are not loaded; instead, the module is loaded as if by <a href="https://docs.microsoft.com/windows/desktop/api/libloaderapi/nf-libloaderapi-loadlibraryexw">LoadLibraryEx</a> with the `DONT_RESOLVE_DLL_REFERENCES` flag. The name specified is the file name of the module and is not related to the name stored in the library module itself, as specified by the <b>LIBRARY</b> keyword in the module-definition (.def) file. If the string specifies a full path, the function searches only that path for the module. If the string specifies a relative path or a module name without a path, the function uses a standard search strategy to find the module; for more information, see the Remarks. If the function cannot find the  module, the function fails. When specifying a path, be sure to use backslashes (\\), not forward slashes (/). For more information about paths, see <a href="https://docs.microsoft.com/windows/desktop/FileIO/naming-a-file">Naming a File or Directory</a>. If the string specifies a module name without a path and the file name extension is omitted, the function appends the default library extension ".DLL" to the module name. To prevent the function from appending ".DLL" to the module name, include a trailing point character (.) in the module name string.</para>
+            <para><see href="https://learn.microsoft.com/windows/win32/api/libloaderapi/nf-libloaderapi-loadlibraryw#parameters">Read more on docs.microsoft.com</see>.</para>
             </param>
             <returns>
-            <para>If the function succeeds, the return value is a handle to the module. If the function fails, the return value is NULL. To get extended error information, call <a href="/windows/desktop/api/errhandlingapi/nf-errhandlingapi-getlasterror">GetLastError</a>.</para>
+            <para>If the function succeeds, the return value is a handle to the module. If the function fails, the return value is NULL. To get extended error information, call <a href="https://docs.microsoft.com/windows/desktop/api/errhandlingapi/nf-errhandlingapi-getlasterror">GetLastError</a>.</para>
             </returns>
             <remarks>
-            <para><see href="https://docs.microsoft.com/windows/win32/api//libloaderapi/nf-libloaderapi-loadlibraryw">Learn more about this API from docs.microsoft.com</see>.</para>
+            <para>To enable or disable error messages displayed by the loader during DLL loads, use the <a href="https://docs.microsoft.com/windows/desktop/api/errhandlingapi/nf-errhandlingapi-seterrormode">SetErrorMode</a> function. <b>LoadLibrary</b> can be used to load a library module into the address space of the process and return a handle that can be used in <a href="https://docs.microsoft.com/windows/desktop/api/libloaderapi/nf-libloaderapi-getprocaddress">GetProcAddress</a> to get the address of a DLL function. <b>LoadLibrary</b> can also be used to load other executable modules. For example, the function can specify an .exe file to get a handle that can be used in <a href="https://docs.microsoft.com/windows/desktop/api/winbase/nf-winbase-findresourcea">FindResource</a> or <a href="https://docs.microsoft.com/windows/desktop/api/libloaderapi/nf-libloaderapi-loadresource">LoadResource</a>. However, do not use <b>LoadLibrary</b> to run an .exe file. Instead, use the <a href="https://docs.microsoft.com/windows/desktop/api/processthreadsapi/nf-processthreadsapi-createprocessa">CreateProcess</a> function. If the specified module is a DLL that is not already loaded for the calling process, the system calls the DLL's <a href="https://docs.microsoft.com/windows/desktop/Dlls/dllmain">DllMain</a> function with the <b>DLL_PROCESS_ATTACH</b> value. If <b>DllMain</b> returns <b>TRUE</b>, <b>LoadLibrary</b> returns a handle to the module. If <b>DllMain</b> returns <b>FALSE</b>, the system unloads the DLL from the process address space and <b>LoadLibrary</b> returns <b>NULL</b>. It is not safe to call <b>LoadLibrary</b> from <b>DllMain</b>. For more information, see the Remarks section in <b>DllMain</b>. Module handles are not global or inheritable. A call to <b>LoadLibrary</b> by one process does not produce a handle that another process can use — for example, in calling <a href="https://docs.microsoft.com/windows/desktop/api/libloaderapi/nf-libloaderapi-getprocaddress">GetProcAddress</a>. The other process must make its own call to <b>LoadLibrary</b> for the module before calling <b>GetProcAddress</b>. If <i>lpFileName</i> does not include a path and there is more than one loaded module with the same base name and extension, the function returns a handle to the module that was loaded first. If no file name extension is specified in the <i>lpFileName</i> parameter, the default library extension .dll is appended. However, the file name string can include a trailing point character (.) to indicate that the module name has no extension. When no path is specified, the function searches for loaded modules whose base name matches the base name of the module to be loaded. If the name matches, the load succeeds. Otherwise, the function searches for the file. The first directory searched is the directory containing the image file used to create the calling process (for more information, see the <a href="https://docs.microsoft.com/windows/desktop/api/processthreadsapi/nf-processthreadsapi-createprocessa">CreateProcess</a> function). Doing this allows private dynamic-link library (DLL) files associated with a process to be found without adding the process's installed directory to the PATH environment variable. If a relative path is specified, the entire relative path is appended to every token in the DLL search path list. To load a module from a relative path without searching any other path, use <a href="https://docs.microsoft.com/windows/desktop/api/fileapi/nf-fileapi-getfullpathnamea">GetFullPathName</a> to get a nonrelative path and call <b>LoadLibrary</b> with the nonrelative path. For more information on the DLL search order, see <a href="https://docs.microsoft.com/windows/desktop/Dlls/dynamic-link-library-search-order">Dynamic-Link Library Search Order</a>. The search path can be altered using the <a href="https://docs.microsoft.com/windows/desktop/api/winbase/nf-winbase-setdlldirectorya">SetDllDirectory</a> function. This solution is recommended instead of using <a href="https://docs.microsoft.com/windows/desktop/api/winbase/nf-winbase-setcurrentdirectory">SetCurrentDirectory</a> or hard-coding the full path to the DLL. If a path is specified and there is a redirection file for the application, the function searches for the module in the application's directory. If the module exists in the application's directory, <b>LoadLibrary</b> ignores the specified path and loads the module from the application's directory. If the module does not exist in the application's directory, <b>LoadLibrary</b> loads the module from the specified directory. For more information, see <a href="https://docs.microsoft.com/windows/desktop/Dlls/dynamic-link-library-redirection">Dynamic Link Library Redirection</a>. If you call <b>LoadLibrary</b> with the name of an assembly without a path specification and the assembly is listed in the system compatible manifest, the call is automatically redirected to the side-by-side assembly. The system maintains a per-process reference count on all loaded modules. Calling <b>LoadLibrary</b> increments the reference count. Calling the <a href="https://docs.microsoft.com/windows/desktop/api/libloaderapi/nf-libloaderapi-freelibrary">FreeLibrary</a> or <a href="https://docs.microsoft.com/windows/desktop/api/libloaderapi/nf-libloaderapi-freelibraryandexitthread">FreeLibraryAndExitThread</a> function decrements the reference count. The system unloads a module when its reference count reaches zero or when the process terminates (regardless of the reference count). <b>Windows Server 2003 and Windows XP:  </b>The Visual C++ compiler supports a syntax that enables you to declare thread-local variables: <b>_declspec(thread)</b>. If you use this syntax in a DLL, you will not be able to load the DLL explicitly using <b>LoadLibrary</b> on versions of Windows prior to Windows Vista. If your DLL will be loaded explicitly, you must use the thread local storage functions instead of <b>_declspec(thread)</b>. For an example, see <a href="https://docs.microsoft.com/windows/desktop/Dlls/using-thread-local-storage-in-a-dynamic-link-library">Using Thread Local Storage in a Dynamic Link Library</a>. <h3><a id="Security_Remarks"></a><a id="security_remarks"></a><a id="SECURITY_REMARKS"></a>Security Remarks</h3> Do not use the <a href="https://docs.microsoft.com/windows/desktop/api/processenv/nf-processenv-searchpathw">SearchPath</a> function to retrieve a path to a DLL for a subsequent <b>LoadLibrary</b> call. The <b>SearchPath</b> function uses a different search order than <b>LoadLibrary</b> and it does not use safe process search mode unless this is explicitly enabled by calling <a href="https://docs.microsoft.com/windows/desktop/api/winbase/nf-winbase-setsearchpathmode">SetSearchPathMode</a> with <b>BASE_SEARCH_PATH_ENABLE_SAFE_SEARCHMODE</b>. Therefore, <b>SearchPath</b> is likely to first search the user’s current working directory for the specified DLL. If an attacker has copied a malicious version of a DLL into the current working directory, the path retrieved by <b>SearchPath</b> will point to the malicious DLL, which <b>LoadLibrary</b> will then load. Do not make assumptions about the operating system version based on a <b>LoadLibrary</b> call that searches for a DLL. If the application is running in an environment where the DLL is legitimately not present but a malicious version of the DLL is in the search path, the malicious version of the DLL may be loaded. Instead, use the recommended techniques described in <a href="https://docs.microsoft.com/windows/desktop/SysInfo/getting-the-system-version">Getting the System Version</a>.</para>
+            <para><see href="https://learn.microsoft.com/windows/win32/api/libloaderapi/nf-libloaderapi-loadlibraryw#">Read more on docs.microsoft.com</see>.</para>
             </remarks>
         </member>
         <member name="T:Windows.Win32.Security.SECURITY_ATTRIBUTES">
             <summary>The SECURITY_ATTRIBUTES structure contains the security descriptor for an object and specifies whether the handle retrieved by specifying this structure is inheritable.</summary>
-            <remarks>
-            <para><see href="https://docs.microsoft.com/windows/win32/api//wtypesbase/ns-wtypesbase-security_attributes#">Read more on docs.microsoft.com</see>.</para>
-            </remarks>
+            <remarks></remarks>
         </member>
         <member name="F:Windows.Win32.Security.SECURITY_ATTRIBUTES.nLength">
             <summary>The size, in bytes, of this structure. Set this value to the size of the **SECURITY\_ATTRIBUTES** structure.</summary>
@@ -4836,7 +4933,7 @@
         <member name="F:Windows.Win32.Security.SECURITY_ATTRIBUTES.lpSecurityDescriptor">
             <summary>
             <para>A pointer to a [**SECURITY\_DESCRIPTOR**](../winnt/ns-winnt-security_descriptor.md) structure that controls access to the object. If the value of this member is **NULL**, the object is assigned the default security descriptor associated with the [*access token*](/windows/win32/secauthz/access-tokens) of the calling process. This is not the same as granting access to everyone by assigning a **NULL** [*discretionary access control list*](/windows/win32/secauthz/dacls-and-aces) (DACL). By default, the default DACL in the access token of a process allows access only to the user represented by the access token. For information about creating a security descriptor, see [Creating a Security Descriptor](/windows/win32/secauthz/creating-a-security-descriptor-for-a-new-object-in-c--).</para>
-            <para><see href="https://docs.microsoft.com/windows/win32/api//wtypesbase/ns-wtypesbase-security_attributes#members">Read more on docs.microsoft.com</see>.</para>
+            <para><see href="https://learn.microsoft.com/windows/win32/api/wtypesbase/ns-wtypesbase-security_attributes#members">Read more on docs.microsoft.com</see>.</para>
             </summary>
         </member>
         <member name="F:Windows.Win32.Security.SECURITY_ATTRIBUTES.bInheritHandle">
@@ -4844,7 +4941,8 @@
         </member>
         <member name="T:System.Runtime.CompilerServices.OverloadResolutionPriorityAttribute">
             <summary>
-            Specifies the priority of a member in overload resolution. When unspecified, the default priority is 0.
+            Specifies the priority of a member in overload resolution.
+            When unspecified, the default priority is 0.
             </summary>
         </member>
         <member name="M:System.Runtime.CompilerServices.OverloadResolutionPriorityAttribute.#ctor(System.Int32)">