<div class="content" name="ElfrRegisterEventSourceA" uuid="85c31da0-b47f-4776-9024-4f0fb09a046c"><p>The ElfrRegisterEventSourceA (Opnum 15) method instructs the
server to return a server context handle to an <a href="e74c8719-c30e-4f7a-bef7-82753cc0e159#gt_bb3fad7e-60bf-46d4-9c3f-7caea47a743e" data-linktype="relative-path">event log</a> for writing. The
caller MUST have permission to write to the file containing the event log for
this to succeed. The module name argument specifies the <a href="e74c8719-c30e-4f7a-bef7-82753cc0e159#gt_efdc035d-100a-4568-a67f-69fb726fadcb" data-linktype="relative-path">event source</a>, which is used
to determine the relevant event log, as specified in the following sections.</p><dl>
<dd>
<div><pre> NTSTATUS ElfrRegisterEventSourceA(
   [in] EVENTLOG_HANDLE_A UNCServerName,
   [in] PRPC_STRING ModuleName,
   [in] PRPC_STRING RegModuleName,
   [in] unsigned long MajorVersion,
   [in] unsigned long MinorVersion,
   [out] IELF_HANDLE* LogHandle
 );
</pre></div>
</dd></dl><p><b>UNCServerName: </b>A server interface handle. A pointer
to an ANSI string (see <a href="https://go.microsoft.com/fwlink/?LinkId=89952" data-linktype="external">[MSDN-ANSI]</a>)
specifying the server, as specified in section <a href="12315f0e-4143-45ee-bcda-490a80e5bed5" data-linktype="relative-path">2.2.7</a>. The client MUST map
this string to an <a href="e74c8719-c30e-4f7a-bef7-82753cc0e159#gt_8a7f6700-8311-45bc-af10-82e10accd331" data-linktype="relative-path">RPC</a>
binding handle, and the server MUST ignore this argument, as specified in <a href="https://go.microsoft.com/fwlink/?LinkId=89824" data-linktype="external">[C706]</a> sections 4.3.5
and 5.1.5.2. </p><p><b>ModuleName: </b>Specifies the event source, as defined in
section <a href="de62a032-2db0-42ff-a7d0-63f55b9c5e39" data-linktype="relative-path">1.8.3</a> and
specified in section <a href="1f02c63c-f59f-40b2-8046-c624f18e7e84" data-linktype="relative-path">2.2.12</a>,
for which a handle is needed.</p><p><b>RegModuleName: </b>This parameter MUST be ignored by the
server. Clients MUST specify an empty string. </p><p><b>MajorVersion: </b>Major version of the client. This value
MUST be set to 1. </p><p><b>MinorVersion: </b>Minor version of the client. This value
MUST be set to 1. </p><p><b>LogHandle: </b>Pointer to an event log handle. This
parameter is a server context handle, as specified in section <a href="de54bfbc-fbe4-43b8-b8e1-b8a6b2189604" data-linktype="relative-path">2.2.6</a>.</p><p><b>Return Values: </b>The method MUST return STATUS_SUCCESS
(0x00000000) on success; otherwise, it MUST return an implementation-based,
nonzero NTSTATUS value specified in <a href="../ms-erref/1bc92ddf-b79e-413c-bbaa-99a5281a6c90" data-linktype="relative-path">[MS-ERREF]</a>.</p><p>This is identical to the <a href="9b18521f-98cb-44f9-ab5c-84f03b790b44" data-linktype="relative-path">ElfrRegisterEventSourceW (section 3.1.4.5)</a>
method except that the <i>ModuleName</i>, <i>RegModuleName</i>, and the <i>UNCServerName</i>
parameters are ANSI strings in this case. </p></div>