Edit

Share via

IEnumEnhancedStorageACT::GetACTs method (ehstorapi.h)

  • Article

Returns an enumeration of all the Addressable Command Targets (ACT) currently connected to the system. If at least one ACT is present, the Enhanced Storage API allocates an array of 1 or more IEnumEnhancedStorageACT pointers.

Syntax

HRESULT GetACTs(
  [out] IEnhancedStorageACT ***pppIEnhancedStorageACTs,
        ULONG               *pcEnhancedStorageACTs
);

Parameters

[out] pppIEnhancedStorageACTs

Array of IEnhancedStorageACT interface pointers that represent the ACTs for all devices connected to the system. This array is allocated within the API.

pcEnhancedStorageACTs

Count of IEnhancedStorageACT pointers returned. This is the dimension of the array represented by pppIEnhancedStorageACTs.

Return value

This method can return one of these values.

Return code Description
S_OK
One or more ACTs were found.
E_INVALIDARG
 pppIEnhancedStorageACTs or pcEnhancedStorageACTs is NULL.
E_OUTOFMEMORY
 Operation failed due to insufficient memory.

Remarks

The memory containing the array of IEnhancedStorageACT interfaces is allocated by the Enhanced Storage API and must be freed by passing the returned pointer to the CoTaskMemFree method.

Requirements

Requirement Value
Minimum supported client Windows Vista with SP2 [desktop apps only]
Minimum supported server Windows Server 2008 R2 [desktop apps only]
Target Platform Windows
Header ehstorapi.h

See also

IEnumEnhancedStorageACT