IVssSoftwareSnapshotProvider：：IsVolumeSupported 方法 (vsprov.h)

判斷提供者是否支援指定磁片區上的陰影複製。

語法

HRESULT IsVolumeSupported(
  [in]  VSS_PWSZ pwszVolumeName,
  [out] BOOL     *pbSupportedByThisProvider
);

[in] pwszVolumeName

以 Null 結尾的寬字元字串，其中包含磁片區名稱。名稱必須是下列其中一種格式，且必須包含尾端反斜線 (\) ：

[out] pbSupportedByThisProvider

如果指定的磁片區支援陰影複製，則此參數會收到 TRUE ，否則為 FALSE。

以下是這個方法的有效傳回碼。

值	意義
S_OK	已成功傳回要求的資訊。
E_ACCESSDENIED	呼叫端沒有足夠的備份許可權，或不是系統管理員。
E_INVALIDARG	其中一個參數值無效。
VSS_E_NESTED_VOLUME_LIMIT	指定的磁片區巢狀太深，無法參與 VSS 作業。 Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP：不支援此傳回碼。
E_OUTOFMEMORY	呼叫端記憶體不足或其他系統資源。
VSS_E_OBJECT_NOT_FOUND	找不到指定的磁片區。
VSS_E_PROVIDER_VETO	提供者錯誤。提供者在事件記錄檔中記錄錯誤。如需詳細資訊，請參閱 VSS 下的事件和錯誤處理。
VSS_E_UNEXPECTED	非預期的錯誤。錯誤碼會記錄在錯誤記錄檔中。如需詳細資訊，請參閱 VSS 下的事件和錯誤處理。 Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP：在 Windows Server 2008 R2 和 Windows 7 之前，不支援此值。 E_UNEXPECTED改用。

IsVolumeSupported方法可以在指定的磁片區上建立陰影複製時傳回TRUE，即使目前的組態目前不允許在該磁片區上建立陰影複製也一樣。

例如，如果指定的磁片區上已達到陰影複製的最大數目 (，因此無法在該磁片區上建立更多陰影複製) ，此方法仍會指出磁片區可以陰影複製。

無法針對位於另一個 VHD 內巢狀的虛擬硬碟 (VHD) 呼叫這個方法。

Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP： 不支援 VHD。