CVssWriter：：OnIdentify 方法 (vswriter.h)

OnIdentify 方法是由接收識別事件的寫入器所呼叫。

OnIdentify 是虛擬方法。它是由 CVssWriter 基類實作，但可由衍生類別覆寫。

語法

bool OnIdentify(
  [in] IVssCreateWriterMetadata *pMetadata
);

[in] pMetadata

IVssCreateWriterMetadata 物件的指標，用來建構寫入器的元數據。

如同基類所實作， OnIdentify 一律會傳回 true。

這個方法的任何其他實作都必須傳回 true， 除非發生嚴重錯誤。如果發生嚴重錯誤，方法應該會傳回 false。

在發生失敗的所有情況下，包括非嚴重錯誤，方法應該將詳細專案寫入事件記錄檔，以報告失敗的確切原因。

CVssWriter 基類的預設此方法實作會傳回 true，而不會執行任何其他作業。

寫入器絕對不應該從這個方法或任何其他 CVssWriter (Ex) ：：OnXxx 回呼方法擲回例外狀況。

寫入器絕不應該從 OnIdentify 或 CVssWriterEx：：OnIdentifyEx 方法呼叫 CVssWriter：：SetWriterFailure 方法。

如果這個方法呼叫 CVssWriterEx2：：GetSessionId 方法，它必須在呼叫這個方法的相同線程中執行此動作。如需詳細資訊，請參閱寫入器事件處理。

為了回應另一個應用程式所產生的識別事件，寫入器會使用 OnIdentify 處理程式來建立寫入器元數據檔，其中包含其使用 IVssCreateWriterMetadata 介面所管理之元件的相關信息。

產生Identify事件的應用程式接著會擷取寫入器元數據檔，並使用 IVssEx，Ex，RiterMetadata 介面檢查寫入器的元件資訊。

在組成備份或還原順序的事件之前，需要識別事件。因此，通常叫用 OnIdentify 來處理 Identify 事件，以回應要求者的 IVssBackupComponents：：GatherWriterMetadata 作為備份或還原作業的一部分。

不過，Identify 事件本身不是組成備份或還原的事件序列的一部分，VSS 服務也不會防止其產生，即使備份或還原順序正在進行也一樣。例如，VSS 管理應用程式會使用 Identify 事件來判斷和顯示系統上寫入器的狀態。

在這種情況下，寫入器絕對不應該使用其 OnIdentify 實作的方式如下：

如需與事件寫入器互動的詳細資訊，請參閱寫入器事件處理。

傳遞至 OnIdentify 的 IVssCreateWriterMetadata 物件的生命週期是由 VSS 基礎結構所管理。