<div class="content" name="ElfrClearELFA" uuid="a982c2f3-66c5-49e2-90a8-c7665470b77b"><p>The ElfrClearELFA (Opnum 12) method instructs the server to
clear an <a href="e74c8719-c30e-4f7a-bef7-82753cc0e159#gt_bb3fad7e-60bf-46d4-9c3f-7caea47a743e" data-linktype="relative-path">event log</a>, and,
optionally, to back up the event log before the clear operation takes place. </p><dl>
<dd>
<div><pre> NTSTATUS ElfrClearELFA(
   [in] IELF_HANDLE LogHandle,
   [in, unique] PRPC_STRING BackupFileName
 );
</pre></div>
</dd></dl><p><b>LogHandle: </b>Handle to the event log to be cleared.
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>. This handle MUST
NOT be one obtained via the <a href="6dcf59eb-11ca-416f-9cc4-8f6c2979baad" data-linktype="relative-path">ElfrOpenBELA (section 3.1.4.2)</a>
method or the <a href="4db1601c-7bc2-4d5c-8375-c58a6f8fc7e1" data-linktype="relative-path">ElfrOpenBELW (section 3.1.4.1)</a>
method.</p><p><b>BackupFileName: </b>Provides an ANSI string (as specified
in section <a href="1f02c63c-f59f-40b2-8046-c624f18e7e84" data-linktype="relative-path">2.2.12</a>) that
points to an <a href="c1550f98-a1ce-426a-9991-7509e7c3787c" data-linktype="relative-path">NT Object Path</a>
of a file (as specified in section 2.2.4.1), in which a current copy of the
event log is to be placed. If this is NULL or empty, the server MUST NOT create
a backup as part of this method.</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>The ElfrClearELFA and <a href="9b7a5f23-0269-4ed7-85ad-a7087af66b44" data-linktype="relative-path">ElfrClearELFW (section 3.1.4.9)</a>
methods are identical in functionality. The difference between the two methods
is that the ElfrClearELFA method specifies <i>BackupFileName</i> as an ANSI
string. The ElfrClearELFW method specifies <i>BackupFileName</i> as a UNICODE
string.</p></div>