Intel AMT Features > Storage Administration and Operations > Use Cases > Admin: Enumerate all Registered Applications
CollapseAll image

Admin: Enumerate all Registered Applications

For display or lookup purposes, it is helpful to have a list of all registered applications. The following steps describe how to retrieve the application handles, and then the information associated with each entry.

1.  Retrieve the instance of AMT_ThirdPartyDataStorageAdministrationService, where the “Name” key equals “Intel(r) AMT Third Party Data Storage Administration Service”.

2.  Invoke AMT_ThirdPartyDataStorageAdministrationService.AdminGetRegisteredApplications to retrieve an array of application handles.

3.  If you need information about each handle, use a loop over the array. For each handle, use AMT_ThirdPartyDataStorageService.AdminGetApplicationAttributes to retrieve the information.

   Pass the handle as an input parameter.

   As output parameters, the method returns the following:

Parameter

Description/Value

AttrType

The Attribute Type: Should always be 1.

UUID

The UUID associated with this instance of the application.

ApplicationName

The name of the application. 64 characters maximum.

Vendorname

The name of the vendor: 64 characters maximum.

EnterpriseName

The name of the enterprise. 64 characters maximum.

CurrentAllocationSize

The number of bytes that the application is currently using.

ActiveSession

Will be true if this application has an active session with Intel AMT, false otherwise.

Partner

Will be true or false, respectively, for partner and non-partner applications.

 

 Note:

Information about all registered applications is returned; both partner and non-partner applications.

4.  Display or otherwise make use of the retrieved data as needed.

Click here for a snippet demonstrating this step

You can execute this snippet by inserting it into the execution template found here.

  

$thirdPartyDataStorageAdministrationServiceRef =$wsmanConnectionObject.NewReference("SELECT * FROM AMT_ThirdPartyDataStorageAdministrationService WHERE Name='Intel(r) AMT Third Party Data Storage Administration Service'")

$inputObject =$thirdPartyDataStorageAdministrationServiceRef.CreateMethodInput("AdminGetRegisteredApplications")

$outputObject =$thirdPartyDataStorageAdministrationServiceRef.InvokeMethod($inputObject)

$returnValue =$outputObject.GetProperty("ReturnValue")

if($returnValue -like "0")

{

    $applicationHandles =$outputObject.GetProperty("ApplicationHandles")

    for($i = 0;$i -lt $applicationHandles.Count;$i++)

    {

          $inputObject =$thirdPartyDataStorageAdministrationServiceRef.CreateMethodInput("AdminGetApplicationAttributes")

          $inputObject.SetProperty("Handle",$applicationHandles.Item($i).ToString())

          $outputObject =$thirdPartyDataStorageAdministrationServiceRef.InvokeMethod($inputObject)

          $returnValue =$outputObject.GetProperty("ReturnValue")

          if($returnValue -like "0")

          {    

                $attrType =$outputObject.GetProperty("AttrType")

                $uuid =$outputObject.GetProperty("UUID")

                $applicationName =$outputObject.GetProperty("ApplicationName")

                $vendorName =$outputObject.GetProperty("VendorName")

                $enterpriseName =$outputObject.GetProperty("EnterpriseName")

                $currentAllocationSize =$outputObject.GetProperty("CurrentAllocationSize")

                $activeSession =$outputObject.GetProperty("ActiveSession")

                $partner =$outputObject.GetProperty("Partner")

          }

    }

}

 

 

Instance Diagram

Not applicable

Classes Used in This Flow

SDK Sample

If there is a sample demonstrating this flow, it is included in the SDK installation file. See SDK Installation Layout for details.

 

See Also:

   Storage Concepts and Objects

   Application Development Guidelines

   Examples of Using the Storage Feature

Copyright © 2006-2022, Intel Corporation. All rights reserved.