Edit

IEnumEnhancedStorageACT::GetMatchingACT method (ehstorapi.h)

  • Article

Returns the Addressable Command Target (ACT) associated with the volume specified via the string supplied by the client.

Syntax

HRESULT GetMatchingACT(
  [in]  LPCWSTR             szVolume,
  [out] IEnhancedStorageACT **ppIEnhancedStorageACT
);

Parameters

[in] szVolume

A string that specifies the volume for which a matching ACT is searched for.

[out] ppIEnhancedStorageACT

Pointer to an IEnhancedStorageACT interface pointer that represents the matching ACT. If no matching ACT is found the error HRESULT_FROM_WIN32(ERROR_NOT_FOUND) is returned.

Return value

This method can return one of these values.

Return code Description
S_OK
 A matching ACT was successfully found.
E_INVALIDARG
 szVolume or ppIEnhancedStorageACT is NULL.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND)
 A matching ACT wasn't found.
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)
 Enhanced storage is not supported on the device containing szVolume.
HRESULT_FROM_WIN32(ERROR_INVALID_FUNCTION)
 Enhanced storage is not supported on the device containing szVolume.

Remarks

This method can also be utilized by the client to determine if the specified volume resides on, and is represented by an IEEE 1667 ACT.

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