IVdsService：：QueryUnallocatedDisks 方法 (vds.h)
[從 Windows 8 和 Windows Server 2012 開始，Windows 記憶體管理 API 會取代虛擬磁碟服務 COM 介面。
傳回列舉物件，其中包含 VDS 所管理的未配置磁碟清單。
語法
HRESULT QueryUnallocatedDisks(
[out] IEnumVdsObject **ppEnum
);
參數
[out] ppEnum
IEnumVdsObject 介面指標的位址，可用來列舉磁碟做為磁碟物件。 如需詳細資訊，請參閱 使用列舉物件。 呼叫端必須在呼叫 IUnknown：：Release 方法不再需要介面和每個磁碟物件時釋放它們。
傳回值
這個方法可以傳回標準 HRESULT 值，例如E_INVALIDARG或E_OUTOFMEMORY，以及 VDS 特定的傳回值。 它也可以使用 HRESULT_FROM_WIN32 宏傳回已轉換的系統錯誤碼。 錯誤可能來自 VDS 本身，或來自正在使用的基礎 VDS 提供者 。 可能的傳回值包括下列專案。
| 傳回碼/值 | 描述 |
|---|---|
|
成功傳回列舉。 |
|
VDS 無法初始化。 如果應用程式在服務完成初始化之前呼叫此方法，則會封鎖 方法，直到初始化完成為止。 如果初始化失敗，則會傳回此錯誤。 |
備註
任何提供者都不會宣告未配置磁碟。 它可能包含 MBR 或 GPT 資料分割格式資訊。 通常是未初始化的磁碟。 如果磁碟狀態 VDS_DS_ONLINE 或 VDS_DS_OFFLINE，則磁碟未配置且未初始化。 如果VDS_DS_UNKNOWN、VDS_DS_NOT_READY、VDS_DS_FAILED或VDS_DS_MISSING，則未配置，但 VDS 服務無法判斷它是否初始化，可能是因為磁碟發生問題。
若要判斷磁碟狀態，請參閱磁碟VDS_DISK_PROP或磁碟VDS_DISK_PROP2結構的狀態成員。
如果磁碟狀態 為VDS_DS_ONLINE，則可以將磁碟新增至套件。
如果磁碟狀態 VDS_DS_OFFLINE，請嘗試呼叫 IVdsDiskOnline：：Online 讓磁碟上線。 如果對 Online 方法的呼叫成功，可以將磁碟新增至套件。 如果對 Online 的呼叫失敗，則無法使用磁碟。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows Vista [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | vds.h |
| 程式庫 | Uuid.lib |