<div class="content" name="GetNtmsServerObjectInformationA" uuid="885e2963-2386-4ce6-a2e0-0ae1b3927c08"><p>The GetNtmsServerObjectInformationA method retrieves
information about an object, as a sequence of ASCII characters.</p><dl>
<dd>
<div><pre> HRESULT GetNtmsServerObjectInformationA(
   [in, unique] LPNTMS_GUID lpObjectId,
   [out] LPNTMS_OBJECTINFORMATIONA 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="9252e471-a237-453a-9727-dbff3c125510" data-linktype="relative-path">NTMS_OBJECTINFORMATIONA</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 <b>dwType</b> field of a given object has a value of
NTMS_UNKNOWN, 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 GetNtmsObjectInformationA 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
ASCII-encoded.</p></div>