IVssSoftwareSnapshotProvider::SetContext 方法 (vsprov.h)

設定後續陰影複製相關作業的內容。

語法

HRESULT SetContext(
  [in] LONG lContext
);

參數

[in] lContext

要設定的內容。 內容必須是 _VSS_SNAPSHOT_CONTEXT 的其中一個支援值,或 _VSS_VOLUME_SNAPSHOT_ATTRIBUTES_VSS_SNAPSHOT_CONTEXT 值的支持組合。

傳回值

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

意義
S_OK
已成功設定內容。
E_ACCESSDENIED
呼叫端沒有足夠的備份許可權,或不是系統管理員。
E_INVALIDARG
其中一個參數值無效。
E_OUTOFMEMORY
呼叫端記憶體不足或其他系統資源。
VSS_E_BAD_STATE
內容已凍結且無法變更。

備註

VSS 陰影複製的預設內容是VSS_CTX_BACKUP。

Windowsxp: 唯一支援的內容是默認內容,VSS_CTX_BACKUP。 因此,在 Windows XP 下呼叫 SetContext 會傳回E_NOTIMPL。

如需 SetContext 所設定之內容如何影響陰影複製的建立和管理方式的詳細資訊,請參閱 建立陰影複製的實作詳細數據

如需允許陰影複製內容的完整討論,請參閱 _VSS_SNAPSHOT_CONTEXT_VSS_VOLUME_SNAPSHOT_ATTRIBUTES

規格需求

需求
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 vsprov.h
程式庫 VssApi.lib

另請參閱

IVssSoftwareSnapshotProvider