IEnhancedStorageACT2::GetDeviceName method (ehstorapi.h)

  • Article

The IEnhancedStorageACT2::GetDeviceName method returns the device name associated with the Addressable Command Target (ACT).

Syntax

HRESULT GetDeviceName(
  [out] LPWSTR *ppwszDeviceName
);

Parameters

[out] ppwszDeviceName

Pointer to a string that represents the device name associated with the ACT.

Return value

This method can return one of the following values:

Return code Description
S_OK
 The associated volume was successfully returned.
E_INVALIDARG
 ppwszDeviceName is NULL.
E_OUTOFMEMORY
 The operation failed due to insufficient memory allocation.

Remarks

The memory containing the device name string is allocated by the Enhanced Storage API and must be freed by passing the returned pointer to CoTaskMemFree.

Requirements

Requirement Value
Minimum supported client Windows 7 [desktop apps only]
Minimum supported server None supported
Target Platform Windows
Header ehstorapi.h

See also

IEnhancedStorageACT2