<div class="content" name="NetrDfsDeleteLocalPartition" uuid="bb2a14a6-a807-41f3-bb30-ab68a47d8756"><p>The NetrDfsDeleteLocalPartition method deletes a <a href="1709f6a7-efb8-4ded-b7ae-5cee9ee36320#gt_0b8086c9-d025-45b8-bf09-6b5eca72713e" data-linktype="relative-path">DFS</a> share (Prefix) on the <a href="1709f6a7-efb8-4ded-b7ae-5cee9ee36320#gt_434b0234-e970-4e8c-bdfa-e16a30d96703" data-linktype="relative-path">server</a>. An implementation
MAY<a id="Appendix_A_Target_139"></a><a aria-label="Product behavior note 139" href="ebb74ff2-abb1-4e1b-a76a-563a5cbbea9a#Appendix_A_139" data-linktype="relative-path">&lt;139&gt;</a> choose to support this
method.</p><dl>
<dd>
<div><pre> NET_API_STATUS NetrDfsDeleteLocalPartition(
   [in, string, unique] SRVSVC_HANDLE ServerName,
   [in] GUID* Uid,
   [in, string] WCHAR* Prefix
 );
</pre></div>
</dd></dl><p><b>ServerName: </b>An <a href="5f8329ee-1965-4ea1-ad35-3b29fbb63232" data-linktype="relative-path">SRVSVC_HANDLE (section 2.2.1.1)</a>
pointer that identifies the server. The <a href="1709f6a7-efb8-4ded-b7ae-5cee9ee36320#gt_60e0e1fa-66fe-41e1-b5e3-ceab97e53506" data-linktype="relative-path">client</a> MUST map this
structure to an RPC binding handle (see <a href="https://go.microsoft.com/fwlink/?LinkId=89824" data-linktype="external">[C706]</a> sections 4.3.5
and 5.1.5.2). The server MUST ignore this parameter.</p><p><b>Uid: </b>Specifies the <a href="1709f6a7-efb8-4ded-b7ae-5cee9ee36320#gt_f49694cc-c350-462d-ab8e-816f0103c6c1" data-linktype="relative-path">GUID</a> of the DFS share to
delete. This GUID MUST be obtained by using the NetrDfsGetInfo (Opnum 4)
method, which is specified in <a href="../ms-dfsnm/95a506a8-cae6-4c42-b19d-9c1ed1223979" data-linktype="relative-path">[MS-DFSNM]</a>
section <a href="../ms-dfsnm/b5dd4568-3ea4-4f27-ae03-3ebb19fa4b13" data-linktype="relative-path">3.1.4.1.6</a>.</p><p><b>Prefix: </b>A pointer to a null-terminated UTF-16
string that contains the path to the DFS share.</p><p><b>Return Values: </b>The method returns 0x00000000
(NERR_Success) to indicate success; otherwise, it returns a nonzero error code.
The method can take any specific error code value, as specified in <a href="../ms-erref/1bc92ddf-b79e-413c-bbaa-99a5281a6c90" data-linktype="relative-path">[MS-ERREF]</a>
section <a href="../ms-erref/18d8fbe8-a967-4f1c-ae50-99ca8e491d2d" data-linktype="relative-path">2.2</a>.</p><p>In response to a NetrDfsDeleteLocalPartition message, the
server SHOULD<a id="Appendix_A_Target_140"></a><a aria-label="Product behavior note 140" href="ebb74ff2-abb1-4e1b-a76a-563a5cbbea9a#Appendix_A_140" data-linktype="relative-path">&lt;140&gt;</a> choose to perform no
processing and return an implementation-specific error code when this method is
called. If the server supports DFS, the server MAY delete a DFS share.</p><p>The <i>Prefix</i> parameter specifies the path of the DFS
share to delete. This string MUST be in one of the following two forms:</p><ul><li><p><span><span> 
</span></span>The first form is \Dfsname\sharename, where <i>Dfsname</i> is the
name of the storage server that hosts the root of a <a href="1709f6a7-efb8-4ded-b7ae-5cee9ee36320#gt_07f90715-4bf2-479d-9c9d-1b2cd585a280" data-linktype="relative-path">standalone DFS implementation</a>;
and <i>sharename</i> is the name of a shared folder that is published on the
DFS host server.</p>
</li><li><p><span><span> 
</span></span>The second form is \DomainName\DomDfsname, where <i>DomainName</i>
is the name of the domain that hosts the <a href="1709f6a7-efb8-4ded-b7ae-5cee9ee36320#gt_639b7503-b879-4ef7-98a8-14adf85bc16d" data-linktype="relative-path">DFS root</a>; and <i>DomDfsname</i>
is the root name of a domain-based DFS implementation that is published in the
directory service of the domain.</p>
</li></ul><p>If the server cannot find a DFS share whose GUID matches the
<i>Uid</i> parameter and whose path matches the <i>Prefix</i> parameter, it
MUST fail the call with an implementation-specific error code. If a matching
share is found, the server deletes the share and returns 0.</p><p>The server MAY<a id="Appendix_A_Target_141"></a><a aria-label="Product behavior note 141" href="ebb74ff2-abb1-4e1b-a76a-563a5cbbea9a#Appendix_A_141" data-linktype="relative-path">&lt;141&gt;</a>
enforce security measures to verify that the caller has the required
permissions to execute this call. If the server enforces these security
measures and the caller does not have the required credentials, the server
SHOULD<a id="Appendix_A_Target_142"></a><a aria-label="Product behavior note 142" href="ebb74ff2-abb1-4e1b-a76a-563a5cbbea9a#Appendix_A_142" data-linktype="relative-path">&lt;142&gt;</a> fail the call.</p></div>