1 files changed, 13 insertions, 1 deletions

diff --git a/src/ext/Util/ca/scanet.h b/src/ext/Util/ca/scanet.h
index 1fee61f8..efe6a408 100644
--- a/src/ext/Util/ca/scanet.h
+++ b/src/ext/Util/ca/scanet.h
@@ -1,4 +1,16 @@
 #pragma once
 // Copyright (c) .NET Foundation and contributors. All rights reserved. Licensed under the Microsoft Reciprocal License. See LICENSE.TXT file in the project root for full license information.
 
-HRESULT GetDomainServerName(LPCWSTR pwzDomain, LPWSTR* ppwzServerName, ULONG flags = 0);
+
+/**
+ * Locates a domain controller (server name) for a given input domain.
+ * Flags can be provided where required (as per those for DsGetDcName) for a specific server to be returned.
+ * NOTE: Where the domain provided is identical to the local machine, this function will return NULL, such that the
+ * result can be provided directly to NetUserAdd or similar functions.
+ *
+ * @param pwzDomain Pointer to the domain name to be queried
+ * @param ppwzServerName Pointer to the server name to be returned
+ * @param flags Flags to be used in the DsGetDcName call(s)
+ * @return HRESULT to indicate if an error was encountered
+ */
+HRESULT GetDomainServerName(LPCWSTR pwzDomain, LPWSTR* ppwzServerName, ULONG flags);