<div class="content" name="GetNtmsServerObjectInformationW" uuid="3f468d97-dd61-428f-b64d-54ccd58b1f9e"><p>The GetNtmsServerObjectInformationW method retrieves
information about an object, as a sequence of Unicode characters.</p><dl>
<dd>
<div><pre> HRESULT GetNtmsServerObjectInformationW(
   [in] LPNTMS_GUID lpObjectId,
   [out] LPNTMS_OBJECTINFORMATIONW lpInfo,
   [in] DWORD dwType,
   [in] DWORD dwSize
 );
</pre></div>
</dd></dl><p><b>lpObjectId: </b>A pointer to the identifier of the
object for which to retrieve information. </p><p><b>lpInfo: </b>A pointer to an <a href="7a583c21-ca5c-4de4-9b65-96f2e1261625" data-linktype="relative-path">NTMS_OBJECTINFORMATIONW</a>
structure describing the properties of the object.</p><p><b>dwType: </b>A value from the <a href="5b190198-a0cb-4e20-90a3-234009357051" data-linktype="relative-path">NtmsObjectsTypes</a>
enumeration defining the type of the object.</p><p><b>dwSize: </b>The size, in bytes, of the appropriate
structure for <i>lpInfo</i>.</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>0x80070005 ERROR_ACCESS_DENIED</td>
  <td>Access denied.</td>
 </tr><tr>
  <td>0x80070008 ERROR_NOT_ENOUGH_MEMORY</td>
  <td>An allocation failure occurred during processing.</td>
 </tr><tr>
  <td>0x80070057 ERROR_INVALID_PARAMETER</td>
  <td>A parameter is missing, or the dwType or dwSize parameter is invalid.</td>
 </tr><tr>
  <td>0x800710D8 ERROR_OBJECT_NOT_FOUND</td>
  <td>The lpObjectId parameter is invalid.</td>
 </tr></tbody></table>
</dd></dl><p>Upon receiving this message the server MUST verify that both
<i>lpObjectId</i> and <i>lpInfo</i> are not NULL. If parameter validation
fails, the server MUST immediately fail the operation and return
ERROR_INVALID_PARAMETER (0x80070057).</p><p>If parameter validation succeeds, the server MUST verify
that the user has the required access rights. If the client does not have the
required access rights, the server MUST return ERROR_ACCESS_DENIED
(0x80070005).</p><p>The caller MUST supply an object ID and an information
structure of at least the size of the defined structure.</p><p>If the given object type is an NTMS_UNKNOWN structure, the
server MUST determine the object type. The information size and type of the
information structure MUST be set correctly in the <i>lpInfo</i> parameter
before calling the GetNtmsServerObjectInformationW method.</p><p>The following objects require special access rights.</p><table><thead>
  <tr>
   <th>
   <p> Object </p>
   </th>
   <th>
   <p> Access </p>
   </th>
  </tr>
 </thead><tbody><tr>
  <td>NTMS_CHANGER</td>
  <td>Requires NTMS_USE_ACCESS to the library.</td>
 </tr><tr>
  <td>NTMS_CHANGER_TYPE</td>
  <td>Requires NTMS_USE_ACCESS to the computer.</td>
 </tr><tr>
  <td>NTMS_COMPUTER</td>
  <td>Requires NTMS_USE_ACCESS to the computer.</td>
 </tr><tr>
  <td>NTMS_DRIVE</td>
  <td>Requires NTMS_USE_ACCESS to the library.</td>
 </tr><tr>
  <td>NTMS_DRIVE_TYPE</td>
  <td>Requires NTMS_USE_ACCESS to the computer.</td>
 </tr><tr>
  <td>NTMS_IEDOOR</td>
  <td>Requires NTMS_USE_ACCESS to the library.</td>
 </tr><tr>
  <td>NTMS_IEPORT</td>
  <td>Requires NTMS_USE_ACCESS to the library.</td>
 </tr><tr>
  <td>NTMS_LIBRARY</td>
  <td>Requires NTMS_USE_ACCESS to the library.</td>
 </tr><tr>
  <td>NTMS_LIBREQUEST</td>
  <td>Requires NTMS_USE_ACCESS to the library.</td>
 </tr><tr>
  <td>NTMS_LOGICAL_MEDIA</td>
  <td>Requires NTMS_USE_ACCESS to the media pool of the logical media.</td>
 </tr><tr>
  <td>NTMS_ MEDIA_POOL</td>
  <td>Requires NTMS_USE_ACCESS to the media pool.</td>
 </tr><tr>
  <td>NTMS_MEDIA_TYPE</td>
  <td>Requires NTMS_USE_ACCESS to the computer.</td>
 </tr><tr>
  <td>NTMS_OPREQUEST</td>
  <td>Requires NTMS_USE_ACCESS to the computer.</td>
 </tr><tr>
  <td>NTMS_PARTITION</td>
  <td>Requires NTMS_USE_ACCESS to the media pool of the side.</td>
 </tr><tr>
  <td>NTMS_PHYSICAL_MEDIA</td>
  <td>Requires NTMS_USE_ACCESS to the media pool.</td>
 </tr><tr>
  <td>NTMS_STORAGESLOT</td>
  <td>Requires NTMS_USE_ACCESS to the library.</td>
 </tr></tbody></table><p>Strings sent to this method as parameters MUST be
Unicode-encoded.</p></div>