CollapseAll image

Admin: Enumerate all Enterprises

Intel AMT requires applications that wish to work with enterprises to use an enterprise handle in the operation request.  You can retrieve all the handles for registered enterprises and then retrieve the enterprise name for each one.

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.EnumerateStorageEaclEntries to retrieve all the handles for registered applications. The method returns an array of handles as an output parameter.

3.  For each handle, invoke AMT_ThirdPartyDataStorageAdministrationService.GetStorageEaclEntry to get the string name of the enterprise.

   Pass the handle to the method as an input parameter.

   The method returns the name of the enterprise as a string output parameter. 64 characters maximum.

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("EnumerateStorageEaclEntries")

$outputObject = $thirdPartyDataStorageAdministrationServiceRef.InvokeMethod($inputObject)

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

if($returnValue -like "0")

{

    $handles = $outputObject.GetProperty("Handles")

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

    {

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

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

          $outputObject = $thirdPartyDataStorageAdministrationServiceRef.InvokeMethod($inputObject)

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

          if($returnValue -like "0")

          {

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

          }

    }

}

 

 

Instance Diagram

Not applicable

Classes Used in This Flow

SDK Sample

Located at:<SDK_root>\Windows\Intel_AMT\Samples\WS-Management\StorageAdministration

 

See Also:

   Storage Concepts and Objects

   Application Development Guidelines

   Examples of Using the Storage Feature

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