共用方式為


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