Edit

Share via

IVdsHwProviderStoragePools::QueryMaxLunCreateSizeInStoragePool method (vds.h)

  • Article

[Beginning with Windows 8 and Windows Server 2012, the Virtual Disk Service COM interface is superseded by the Windows Storage Management API.]

Returns the maximum size of the LUN that can be created in the storage pool based on the specified LUN type and hints.

Syntax

HRESULT QueryMaxLunCreateSizeInStoragePool(
  [in]  VDS_LUN_TYPE  type,
  [in]  VDS_OBJECT_ID StoragePoolId,
  [in]  VDS_HINTS2    *pHints2,
  [out] ULONGLONG     *pullMaxLunSize
);

Parameters

[in] type

A VDS_LUN_TYPE enumeration value that specifies the LUN type. This parameter is required and must be a valid LUN type.

[in] StoragePoolId

A VDS_OBJECT_ID (GUID) value that identifies the storage pools to be used to create the new LUN. This parameter is required and cannot be GUID_NULL.

[in] pHints2

A pointer to a VDS_HINTS2 structure that contains hints to be used in creating the LUN.

[out] pullMaxLunSize

The address of a ULONGLONG value that receives the maximum LUN size, in bytes.

Return value

This method can return standard HRESULT values, such as E_INVALIDARG or E_OUTOFMEMORY, and VDS-specific return values. It can also return converted system error codes using the HRESULT_FROM_WIN32 macro. Errors can originate from VDS itself or from the underlying VDS provider that is being used. Possible return values include the following.

Return code Description
S_OK
 The method completed successfully.

Requirements

Requirement Value
Minimum supported client Windows 7 [desktop apps only]
Minimum supported server Windows Server 2008 R2 [desktop apps only]
Target Platform Windows
Header vds.h
Library Uuid.lib

See also

IVdsHwProviderStoragePools