<div class="content"><p> </p><p>The NetrMessageNameAdd (Opnum 0) interface is used to
configure the <span><a href="1bb1da94-fc7e-484c-ad2a-4e0d257a50ce#gt_18623b87-0e55-44bc-a5d3-d49388e1716a" data-linktype="relative-path">message server</a></span> to
listen for messages sent to an additional <span><a href="1bb1da94-fc7e-484c-ad2a-4e0d257a50ce#gt_0334e0bd-2755-42f6-aeff-2d4a22bf4abf" data-linktype="relative-path">NetBIOS name</a></span>.</p><dl>
<dd>
<div><pre> NET_API_STATUS NET_API_FUNCTION NetrMessageNameAdd(
   [in, string, unique] MSGSVC_HANDLE ServerName,
   [in, string] wchar_t* MsgName
 );
</pre></div>
</dd></dl><p><b>ServerName: </b>A pointer to a null-terminated
string that MUST denote the NetBIOS name (as specified in <span><a href="https://go.microsoft.com/fwlink/?LinkId=90260" data-linktype="external">[RFC1001]</a></span>
section 5.2) or the <span><a href="1bb1da94-fc7e-484c-ad2a-4e0d257a50ce#gt_1769aec9-237e-44ed-9014-1abb3ec6de6e" data-linktype="relative-path">fully qualified domain name
(FQDN)</a></span> of the remote computer on which the function is to execute.
There are no other constraints on the format of this string. The message server
MUST ignore this parameter.</p><p><b>MsgName: </b>A null-terminated <span><a href="1bb1da94-fc7e-484c-ad2a-4e0d257a50ce#gt_c305d0ab-8b94-461a-bd76-13b40cb8c4d8" data-linktype="relative-path">Unicode</a></span>
string that MUST denote the recipient name to add. The name is not guaranteed
to be unique or reachable by this method. The string MUST be represented using
Unicode UTF-16.</p><p><b>Return Values: </b>A <span><a href="../ms-dtyp/19cdb498-c67b-42b7-a540-4bc6a73c04f6" data-linktype="relative-path">NET_API_STATUS</a></span>
value that indicates return status. If the method returns a negative value, the
method has failed. If the 12-bit facility code (bits 16–27) is set to 0x007,
the value contains a Win32 error code (defined in <span><a href="../ms-erref/1bc92ddf-b79e-413c-bbaa-99a5281a6c90" data-linktype="relative-path">[MS-ERREF]</a></span>)
in the lower 16 bits. Zero or positive values indicate success, with the lower
16 bits in positive nonzero values containing warnings or flags defined in the
method implementation.</p><table><thead>
  <tr>
   <th>
   <p>Return value/code</p>
   </th>
   <th>
   <p>Description</p>
   </th>
  </tr>
 </thead><tbody><tr>
  <td>
  <p>0x00000000</p>
  <p>ERROR_SUCCESS</p>
  </td>
  <td>
  <p>The operation completed successfully.</p>
  </td>
 </tr><tr>
  <td>
  <p>0x00000005</p>
  <p>ERROR_ACCESS_DENIED</p>
  </td>
  <td>
  <p>Access is denied.</p>
  </td>
 </tr><tr>
  <td>
  <p>0x0000007B</p>
  <p>ERROR_INVALID_NAME</p>
  </td>
  <td>
  <p>The file name, directory name, or volume label syntax
  is incorrect.</p>
  </td>
 </tr><tr>
  <td>
  <p>0x00000859</p>
  <p>NERR_NetworkError</p>
  </td>
  <td>
  <p>A general network error occurred.</p>
  </td>
 </tr><tr>
  <td>
  <p>0x0000085C</p>
  <p>NERR_InternalError</p>
  </td>
  <td>
  <p>An internal error occurred.</p>
  </td>
 </tr><tr>
  <td>
  <p>0x000008E4</p>
  <p>NERR_AlreadyExists</p>
  </td>
  <td>
  <p>This message alias already exists locally.</p>
  </td>
 </tr><tr>
  <td>
  <p>0x000008E5</p>
  <p>NERR_TooManyNames</p>
  </td>
  <td>
  <p>The maximum number of added message aliases has been
  exceeded.</p>
  </td>
 </tr><tr>
  <td>
  <p>0x000008F9</p>
  <p>NERR_DuplicateName</p>
  </td>
  <td>
  <p>The name specified is already in use as a message
  alias on the network.</p>
  </td>
 </tr></tbody></table><p> </p></div>