傳回包含使用者指定之 錯誤編號 子類型 錯誤 的 Variant。
語法
CVErr ( 錯誤編號 )
必要 錯誤編號引數 為任何有效的錯誤編號。
註解
使用 CVErr 函數在使用者建立的程式中建立使用者定義的錯誤。 例如，如果您建立接受數個自變數且通常會傳回字串的函數，您可以讓函數評估輸入自變數，以確保它們在可接受的範圍之內。 如果沒有，很可能您的函數不會傳回您預期的結果。 在此事件中， CVErr 可讓您傳回錯誤編號，告訴您要採取什麼動作。
請注意，不允許隱含轉換 錯誤 。 例如，您無法直接將 CVErr 的傳回值指派給不是 Variant 的 變數 。 不過，您可以使用 CInt、 CDbl 等 (執行明確的轉換) CVErr 傳回的值，並將它指派給適當的 資料類型變數。
範例
附註: 下列範例示範如何在 Visual Basic for Applications (VBA) 模組中使用此函數。 如需使用 VBA 的詳細資訊，請在 [搜尋] 旁的下拉式清單中選取 [開發人員參考]，並在 [搜尋] 方塊中輸入一個或多個字詞。
此範例使用 CVErr 函數傳回 VarType 為 vbError (10) 的 Variant。 如果自變數不是數位，使用者定義 CalculateDouble 函數會傳回錯誤。 您可以使用 CVErr 從使用者定義的程式傳回使用者定義的錯誤，或延後處理運行時間錯誤。 使用 IsError 函數來測試值是否代表錯誤。
' Call CalculateDouble with an error-producing argument.
Sub Test()
Debug.Print CalculateDouble("345.45robert")
End Sub
' Define CalculateDouble Function procedure.
Function CalculateDouble(Number)
If IsNumeric(Number) Then
CalculateDouble = Number * 2 ' Return result.
Else
CalculateDouble = CVErr(2001) ' Return a user-defined error
End If ' number.
End Function
