探索 MSFT_StorageProvider 類別的方法
探索記憶體提供者所擁有的物件。
當使用者需要明確探索或重新列舉記憶體提供者所擁有的物件時，會使用這個方法。 呼叫這個方法會導致完整或部分快取失效，以及對儲存子系統的無線呼叫來探索新的或更新的物件。 因為這是昂貴的工作，因此應該謹慎使用此方法。
探索作業的範圍是由 DiscoveryLevel 和 RootObject 參數所控制。 DiscoveryLevel 控制物件探索的深度。 RootObject 會定義探索的起點。
語法
UInt32 Discover(
[in] UInt16 DiscoveryLevel,
[in] MSFT_StorageObject REF RootObject,
[in] Boolean RunAsJob,
[out] MSFT_StorageJob REF CreatedStorageJob,
[out] String ExtendedStatus
);
參數
DiscoveryLevel [in]
應該執行的探索層級 (或深度) 。 只有在根對像是儲存提供者、儲存子系統或 NULL 時，才能指定此參數。 指定時，儲存提供者會從 層級 0 開始探索物件，並繼續直到達到指定的層級為止。 也會探索探索到) (對象之間的關聯。
| 值 | 意義 |
|---|---|
| 層級 0 0 | 將會探索儲存提供者、儲存子系統和檔案器物件。 注意：從 Windows 10 開始：已新增檔案器物件的探索。 |
| 層級 1 1 | 將會探索存放集區、檔案共享、復原設定、目標埠、目標入口網站和啟動器標識碼。 注意：從 Windows 10 開始：已新增檔案共用探索。 |
| 層級 2 2 | 將會探索虛擬磁碟、磁碟區、分割區、磁碟和遮罩集。 注意：從 Windows 10 開始：已新增磁碟區、分割區和磁碟的探索。 |
| 層級 3 3 | 將會探索實體磁碟。 |
RootObject [in]
如果設定此參數，探索將會從這個對象開始。 當 DiscoveryLevel 為 NULL 時，將會根據 RootObject 所指定的物件類型，採取定義完善的動作：
- 儲存子系統：將會探索所有相關聯的物件。
- 存放集區：將會探索集區，以及任何相關聯的復原設定、虛擬磁碟和實體磁碟。
- 遮罩集：會探索遮罩集，以及任何相關聯的目標埠、啟動器標識碼和虛擬磁碟。
- 對於所有其他物件，只會探索或重新整理該物件。
RunAsJob [in]
如果 為 TRUE，這個方法會在要求需要很長的時間才能服務時使用 CreatedStorageJob 參數。 如果已建立記憶體作業來追蹤作業，這個方法會傳回 [已檢查的方法參數 - 作業已啟動]。
注意
即使 RunAsJob 為 TRUE，此方法仍可在有足夠的時間完成時傳回結果。
如果 為 FALSE 或 NULL，這個方法會遵循預設 WMI 異步行為，如用戶端的叫用方法所決定。 換句話說，除非另有要求，否則它是同步的。
CreatedStorageJob [out]
如果 RunAsJob 設定為 TRUE ，而且這個方法需要很長的時間才能執行，則此參數會收到用來追蹤長時間執行作業之記憶體作業對象的參考。
ExtendedStatus [out]
包含內嵌 MSFT_StorageExtendedStatus 物件的字串。
此參數可讓儲存提供者傳回擴充 (實作特定) 錯誤資訊。
傳回值
成功 (0)
不支援 (1)
未指定的錯誤 (2)
逾 時 (3)
失敗 (4)
無效的參數 (5)
已檢查方法參數 - 作業啟動 (4096)
(40001) 拒絕存取
沒有足夠的資源可完成作業。 (40002)
無法連線到記憶體提供者。 (46000)
儲存提供者無法連線到儲存子系統。 (46001)
記憶體提供者不支援必要的配置檔。 (46002)
記憶體提供者不支援必要的關聯。 (46003)
根物件的探索失敗。 (46009 )
在一或多個子系統上探索失敗。 (46010)
備註
記憶體提供者應在啟動時完成 層級 0 探索。 MSFT_StorageProvider和MSFT_StorageSubSystem對象應該載入快取中。
為了獲得更佳的效能，將 iSCSITargetCreationScheme 屬性設定為 Auto 的儲存子系統應該在 層級 2 中探索目標埠以及虛擬磁碟。 請注意，目標入口網站仍應在 層級 1 中探索。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 8 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2012 [僅限傳統型應用程式] |
| 命名空間 | Root\Microsoft\Windows\Storage |
| MOF | Storagewmi.mof |