共用方式為


CreateVssEx surveyWriterMetadata 函式 (vsbackup.h)

CreateVssExriterMetadata函式會建立IVssEx以WriterMetadata物件。

注意 此函式會匯出為 CreateVssEx,WriterMetadataInternal,但您應該呼叫 CreateVssExnalWriterMetadata,而不是 CreateVssExnalWriterMetadataInternal

 

語法

HRESULT CreateVssExamineWriterMetadata(
  [in]  BSTR                      bstrXML,
  [out] IVssExamineWriterMetadata **ppMetadata
);

參數

[in] bstrXML

XML 字串,其中包含寫入器元資料檔案,用來初始化傳回的 IVssEx,WriterMetadata 物件。

[out] ppMetadata

接收物件 之 IVssEx的WriterMetadata 介面指標的變數。

傳回值

此處所列的傳回值除了一般 COM HRESULT 之外,隨時都可以從 函式傳回。

意義
S_OK
已成功傳回 IVssExriterMetadata 介面的指標。
E_ACCESSDENIED
呼叫端沒有足夠的備份許可權,或不是系統管理員。
E_INVALIDARG
其中一個參數無效。
E_OUTOFMEMORY
記憶體不足或其他系統資源。
VSS_E_INVALID_XML_DOCUMENT
在 bstrXML參數中傳遞的 XML 檔無效,也就是說,它不是格式正確的 XML 字串,或不符合架構。
VSS_E_UNEXPECTED
非預期的錯誤。 錯誤碼會記錄在錯誤記錄檔中。 如需詳細資訊,請參閱 VSS 下的事件和錯誤處理

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

備註

若要將寫入器的寫入器元資料檔案複本儲存到 XML 字串中,以傳入 bstrXML 參數,請使用 IVssEx以WriterMetadata::SaveAsXML 方法。

若要擷取寫入器的寫入器元資料檔案最新版本,請使用 IVssBackupComponents::GetWriterMetadata 方法。

若要將寫入器元資料檔案載入現有的 IVssExriterMetadata 物件,請使用 IVssEx,WriterMetadata::LoadFromXML 方法。

使用者不應該嘗試修改寫入器元資料檔案的內容。

呼叫應用程式負責呼叫 IUnknown::Release ,以在不再需要物件時釋放 IVssEx,WriterMetadata 物件所持有的資源。

規格需求

   
最低支援的用戶端 Windows XP [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2003 [僅限桌面應用程式]
目標平台 Windows
標頭 vsbackup.h (包括 VsBackup.h、Vss.h、VsWriter.h)
程式庫 VssApi.lib
Dll VssApi.dll

另請參閱

IVssEx surveyWriterMetadata