<div class="content" name="DeleteClassAsync" uuid="3645bc46-4427-451c-b1b4-1417b7db735c"><p>The IWbemServices::DeleteClassAsync method is the
asynchronous version of the <a href="8dfd1ffb-324c-4ebd-944f-abb4500d14af" data-linktype="relative-path">IWbemServices::DeleteClass</a>
method. The DeleteClassAsync method MUST delete a specified class from the
namespace.</p><dl>
<dd>
<div><pre> HRESULT DeleteClassAsync(
   [in] const BSTR strClass,
   [in] long lFlags,
   [in] IWbemContext* pCtx,
   [in] IWbemObjectSink* pResponseHandler
 );
</pre></div>
</dd></dl><p><b>strClass: </b>MUST be the name of the class to
delete. This parameter MUST NOT be NULL.</p><p><b>lFlags: </b>Specifies the behavior of the
DeleteClassAsync method. Flag behavior MUST be interpreted as specified in the
following table.</p><dl>
<dd>
<table><thead>
  <tr>
   <th>
   <p>Value</p>
   </th>
   <th>
   <p>Meaning</p>
   </th>
  </tr>
 </thead><tbody><tr>
  <td>WBEM_FLAG_SEND_STATUS 0x00000080</td>
  <td>If this bit is not set, the server MUST make one final IWbemObjectSink::SetStatus call on the interface pointer that is provided in the pResponseHandler parameter. If this bit is set, the server MAY make intermediate IWbemObjectSink::SetStatus calls on the interface pointer prior to call completion.</td>
 </tr></tbody></table>
</dd>
<dd>
<p>Any other DWORD value that does
not match the preceding condition MUST be treated as not valid.</p>
</dd></dl><p><b>pCtx: </b>MUST be a pointer to an <a href="18c8f1a1-652f-43b7-9186-6098bc303a8d" data-linktype="relative-path">IWbemContext</a> interface,
which MUST contain additional information that the client wants to pass to the
server. If pCtx is NULL, the parameter MUST be ignored.</p><p><b>pResponseHandler: </b>MUST be a pointer to an <a href="0ddb4f22-371a-4697-af5b-d4184b179b68" data-linktype="relative-path">IWbemObjectSink</a> interface
object that is implemented by the client of this method. This parameter MUST
NOT be NULL.</p><p><b>Return Values: </b>This method MUST return an
HRESULT value that MUST indicate the status of the method call. The server MUST
return WBEM_S_NO_ERROR (as specified in section <a href="a2899649-a5a3-4b13-9ffa-d8394dcdac63" data-linktype="relative-path">2.2.11</a>) to indicate the
successful completion of the method.</p><dl>
<dd>
<p><b>WBEM_S_NO_ERROR</b> (0x00)</p>
</dd></dl><p>The following validation occurs before asynchronous
operation is started:</p><p>The <a href="6837a7cb-ba2d-46b1-802c-fce2fd5a6ad6#gt_f3ef2572-95cf-4c5c-b3c9-551fd648f409" data-linktype="relative-path">security
principal</a> that makes the call MUST have WBEM_REMOTE_ENABLE and WBEM_ENABLE
accesses to the namespace; otherwise, WBEM_E_ACCESS_DENIED MUST be returned.</p><p>The server SHOULD enforce a maximum length for the <i>strClass</i>
parameter and return WBEM_E_QUOTA_VIOLATION if the limit is exceeded.<a id="Appendix_A_Target_39"></a><a aria-label="Product behavior note 39" href="27182640-aa3f-43b6-941f-a77d25f798e8#Appendix_A_39" data-linktype="relative-path">&lt;39&gt;</a></p><p>The requirements mentioned in the parameter definitions are
also checked before starting the asynchronous operation.</p><p>If successful, the server MUST create a new entry in <b>AsyncOperationTable</b>
as specified in section <a href="83a955c3-2fba-4d06-bd88-76ed9bbada43" data-linktype="relative-path">3.1.1.1.3</a>.</p><p>The following validation occurs asynchronously:</p><p>If the CIM class being deleted is <a href="6837a7cb-ba2d-46b1-802c-fce2fd5a6ad6#gt_b11172af-9369-448d-9722-444eb52b21cb" data-linktype="relative-path">dynamic</a>, the security
principal that makes the call MUST have WBEM_WRITE_PROVIDER access to the
namespace; otherwise, WBEM_E_ACCESS_DENIED MUST be returned.</p><p>If the CIM class being deleted is static, the security
principal that makes the call MUST have WBEM_FULL_WRITE access to the
namespace; otherwise, WBEM_E_ACCESS_DENIED MUST be returned.</p><p>If the CIM class being deleted is dynamic, the server MUST
obtain <b>SupportsDelete</b> for the given provider in the <b>ProviderTable</b>.
If <b>SupportsDelete</b> is FALSE, the server MUST return
WBEM_E_PROVIDER_NOT_CAPABLE.</p><p>In response to the IWbemServices::DeleteClassAsync method,
the server MUST evaluate the <i>strClass</i> parameter (specified in this
section) and MUST delete <i>strClass</i> from the current namespace. The server
MUST delete all the instances of the class and recursively delete all the
derived classes. The method MUST fail if the following applies: if <i>strClass</i>
does not exist; if the method parameters or their combinations are not valid as
previously specified; or if the server is unable to execute the method.</p><p>If a new class is deleted, the corresponding entries for the
class and the derived classes MUST be deleted from the <b>ClassTable</b>.</p><p>The server MUST generate a <b>__ClassDeletionEvent</b> event
object upon successfully deleting the class information.</p></div>