<div class="content" name="GetDataSetNumber" uuid="75bafa45-c9ec-4e70-8f4d-eb8408247557"><p>The GetDataSetNumber method returns the dataset number
associated with a node in the <a href="1243ba70-74ca-44f9-be0b-dfd6697010b4#gt_086b13f2-2715-4000-a16c-6acc3d59cc19" data-linktype="relative-path">metabase</a>.
A dataset number is a unique number identifying the data items at that node,
including inherited data items. Nodes with the same dataset number have
identical data.</p><dl>
<dd>
<div><pre> HRESULT GetDataSetNumber(
   [in] METADATA_HANDLE hMDHandle,
   [unique, in, string] LPCWSTR pszMDPath,
   [out] DWORD* pdwMDDataSetNumber
 );
</pre></div>
</dd></dl><p><b>hMDHandle: </b>An unsigned 32-bit integer value
containing an open metabase handle specifying the key to be queried.</p><p><b>pszMDPath: </b>A pointer to a Unicode string that
contains the path of the node to have its dataset number retrieved, relative to
the path of the <i>hMDHandle</i> parameter.</p><p><b>pdwMDDataSetNumber: </b>A pointer to an integer
value that returns the number associated with this dataset. This value can be
used to identify datasets common to multiple nodes.</p><p><b>Return Values: </b>A signed 32-bit value that
indicates return status. If the method returns a negative value, it failed. If
the 12-bit facility code (bits 16–27) is set to 0x007, the value contains a
Win32 error code 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. For more information about Win32
error codes and <a href="../ms-dtyp/a9046ed2-bfb2-4d56-a719-2824afce59ac" data-linktype="relative-path">HRESULT</a>
values, see <a href="../ms-erref/1bc92ddf-b79e-413c-bbaa-99a5281a6c90" data-linktype="relative-path">[MS-ERREF]</a>.</p><dl>
<dd>
<table><thead>
  <tr>
   <th>
   <p>Return value/code</p>
   </th>
   <th>
   <p>Description</p>
   </th>
  </tr>
 </thead><tbody><tr>
  <td>0x00000000 S_OK</td>
  <td>The call was successful.</td>
 </tr><tr>
  <td>0x80070057 E_INVALIDARG</td>
  <td>One or more arguments are invalid.</td>
 </tr></tbody></table>
</dd></dl><p>The <a href="1243ba70-74ca-44f9-be0b-dfd6697010b4#gt_e127848e-c66d-427d-b3aa-9f904fa4ada7" data-linktype="relative-path">opnum</a>
field value for this method is 23. </p><p>When processing this call, the server MUST do the following:</p><ul><li><p><span><span> 
</span></span>Determine the metabase node that most closely matches the path
specified by <i>pszMDPath</i>. If no part of the path specified matches a node
in the metabase, the server returns the data set number of the metabase key
referenced by the <i>hMDHandle</i> parameter. Otherwise, the server returns the
data set number of the most closely matching node. The dataset number for the
METADATA_MASTER_ROOT_HANDLE is 1.</p>
</li></ul></div>