Share via

IVssExmentWriterMetadata：：GetIdentity 方法 (vsbackup.h)

  • 發行項

GetIdentity 方法會取得特定寫入器實例的基本資訊。

語法

HRESULT GetIdentity(
  [out] VSS_ID          *pidInstance,
  [out] VSS_ID          *pidWriter,
  [out] BSTR            *pbstrWriterName,
  [out] VSS_USAGE_TYPE  *pUsage,
  [out] VSS_SOURCE_TYPE *pSource
);

參數

[out] pidInstance

接收寫入器實例識別碼之呼叫端配置的變數位址。

[out] pidWriter

接收寫入器類別識別碼之呼叫端配置的變數位址。

[out] pbstrWriterName

呼叫端配置的變數位址，接收包含寫入器名稱的字串。

[out] pUsage

呼叫端配置的變數位址，該變數會接收 VSS_USAGE_TYPE 列舉值，指定寫入器所管理的數據在主機系統上的使用方式。

[out] pSource

呼叫端配置的變數位址，該變數會接收指定寫入器所管理之數據類型 的VSS_SOURCE_TYPE 列舉值。

傳回值

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

值 意義
S_OK
 已成功傳回身分識別資訊。
E_INVALIDARG
 其中一個參數值無效。
E_OUTOFMEMORY
 呼叫端記憶體不足或其他系統資源。
VSS_E_INVALID_XML_DOCUMENT
 XML 檔無效。 請檢查事件記錄檔以取得詳細數據。 如需詳細資訊，請參閱 VSS 下的事件和錯誤處理。
VSS_E_UNEXPECTED
 非預期的錯誤。 錯誤碼會記錄在錯誤記錄檔中。 如需詳細資訊，請參閱 VSS 下的事件和錯誤處理。

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

備註

呼叫端必須呼叫 SysFreeString 來釋放 pbstrWriterName 參數所保留的記憶體。

IVssExrovWriterMetadata 介面可能來自儲存的寫入器狀態資訊， (呼叫 CreateVssExizeWriterMetadata) 所建立。 如果是這種情況，則下列為 true：

  • pidInstance 可能不代表即時寫入器的任何專案。
  • 如果 pidWriter 不符合任何即時寫入器的寫入器類別，則要求者不應該使用該寫入器的元件。

規格需求

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

另請參閱

CreateVssExrovWriterMetadata

IVssExrovWriterMetadata

VSS_SOURCE_TYPE

VSS_USAGE_TYPE