Admin: Enumerate all Partner Application's FPACL Entries

Intel AMT Features > Storage Administration and Operations > Use Cases > Admin: Enumerate all Partner Application's FPACL Entries

Admin: Enumerate all Partner Application’s FPACL Entries

For display or lookup purposes, it is helpful to have a list of all registered applications. The following steps describe how to retrieve the FPACL and NPACL 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.EnumerateStorageAllocEntries. The method returns an array of FPACL handles as the output parameter.

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

• Pass the FPACL handle as an input parameter.

• As output parameters, the method returns the following:

Parameter	Description/Value
AttrType	The Attribute Type: Should always be 1.
ApplicationName	The name of the application. 64 characters maximum.
Vendorname	The name of the vendor: 64 characters maximum.
IsPartner	Will be true or false, respectively, for partner and non-partner applications
TotalAllocationSize	The total number of bytes that the application can use.

Note:

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

Click here for a snippet demonstrating this step

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

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

$inputObject =$storageAdministrationServiceRef.CreateMethodInput("EnumerateStorageAllocEntries")

$outputObject =$storageAdministrationServiceRef.InvokeMethod($inputObject)

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

if($returnValue -like "0")

{

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

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

{

$inputObject =$storageAdministrationServiceRef.CreateMethodInput("GetStorageAllocEntry")

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

$outputObject =$storageAdministrationServiceRef.InvokeMethod($inputObject)

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

if($returnValue -like "0")

{

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

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

$isPartner =$outputObject.GetProperty("IsPartner")

$totalAllocationSize =$outputObject.GetProperty("TotalAllocationSize")

}

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

Instance Diagram

Not applicable

Classes Used in This Flow

• AMT_ThirdPartyDataStorageAdministrationService

SDK Sample

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