CVssWriterEx::SubscribeEx 方法 (vswriter.h)

讓寫入器訂閱 VSS 事件。

語法

HRESULT SubscribeEx(
  [in] DWORD dwUnsubscribeTimeout,
  [in] DWORD dwEventFlags
);

參數

[in] dwUnsubscribeTimeout

方法在逾時之前會等候的時間長度,以毫秒為單位。

[in] dwEventFlags

VSS_SUBSCRIBE_MASK值的位掩碼,指出 VSS 應該通知寫入器的事件。

這個自變數的預設值為 (VSS_SM_BACKUP_EVENTS_FLAG | VSS_SM_RESTORE_EVENTS_FLAG) 。 目前,呼叫端不應覆寫預設值。

這個參數保留給未來使用。

傳回值

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

意義
S_OK
寫入器已成功訂閱。
E_ACCESSDENIED
呼叫端沒有足夠的備份許可權,或不是系統管理員。
E_OUTOFMEMORY
呼叫端記憶體不足或其他系統資源。
VSS_E_UNEXPECTED
非預期的錯誤。 錯誤碼會記錄在錯誤記錄檔中。 如需詳細資訊,請參閱 VSS 下的事件和錯誤處理

Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP: 在 Windows Server 2008 R2 和 Windows 7 之前,不支援此值。 E_UNEXPECTED改用。

VSS_E_WRITER_ALREADY_SUBSCRIBED
寫入器先前已呼叫這個方法。

規格需求

需求
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 vswriter.h (包括 Vss.h、VsWriter.h)
程式庫 VssApi.lib

另請參閱

CVssWriter::Subscribe

CVssWriterEx