IVssBackupComponents：：GetWriterMetadataCount 方法 (vsbackup.h)

GetWriterMetadataCount 方法會傳回具有元數據的寫入器數目。

語法

HRESULT GetWriterMetadataCount(
  [out] UINT *pcWriters
);

[out] pcWriters

具有元數據的寫入器數目。

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

值	意義
S_OK	已成功傳回具有元數據的寫入器數目。
E_INVALIDARG	其中一個參數值無效。
VSS_E_BAD_STATE	備份元件物件未初始化、在還原作業期間呼叫此方法，或未在正確的順序內呼叫此方法。
VSS_E_UNEXPECTED	非預期的錯誤。錯誤碼會記錄在錯誤記錄檔中。如需詳細資訊，請參閱 VSS 下的事件和錯誤處理。 Windows Server 2008、Windows Vista、Windows Server 2003 和 Windows XP：在 Windows Server 2008 R2 和 Windows 7 之前，不支援此值。 E_UNEXPECTED改用。

要求者必須呼叫異步操作 IVssBackupComponents：：GatherWriterMetadata ，並在呼叫 IVssBackupComponents：：GetWriterMetadataCount 之前等候它完成。

GetWriterMetadataCount 所傳回的寫入器數目應該一律與 IVssBackupComponents：：GetWriterStatusCount 所傳回的寫入器數目相同。

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