CreateVssExmentWriterMetadataInternal 函式 (vsbackup.h)

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

注意此函式會導出為 CreateVssExnalWriterMetadataInternal，但您應該呼叫 CreateVssExnalWriterMetadata，而不是 CreateVssExnalWriterMetadataInternal。

語法

HRESULT CreateVssExamineWriterMetadataInternal(
  [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 參數，請使用 IVssExriterMetadata：：SaveAsXML 方法。

若要擷取寫入器的寫入器元數據檔最新版本，請使用 IVssBackupComponents：：GetWriterMetadata 方法。

若要將寫入器元數據檔載入現有的 IVssExriterMetadata 物件，請使用 IVssExtomWriterMetadata：：LoadFromXML 方法。

使用者不應該嘗試修改寫入器元數據檔的內容。

呼叫應用程式負責呼叫 IUnknown：：Release ，以在不再需要對象時釋放 IVssEx uniqueWriterMetadata 物件所持有的資源。

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