kelas __ExtendedStatus

Artikel
11/10/2023

Kelas sistem __ExtendedStatus digunakan untuk melaporkan status terperinci dan informasi kesalahan.

Sintaks berikut disederhanakan dari kode Managed Object Format (MOF) dan menyertakan semua properti yang diwariskan. Properti tercantum dalam urutan alfabet, bukan urutan MOF.

Sintaks

class __ExtendedStatus : __NotifyStatus
{
  string Description;
  string Operation;
  string ParameterInfo;
  string ProviderName;
  uint32 StatusCode;
};

Anggota

Kelas __ExtendedStatus memiliki jenis anggota ini:

Properti

Properti

Kelas __ExtendedStatus memiliki properti ini.

Keterangan

Jenis data: string
Jenis akses: Baca-saja

Setiap string yang ditentukan pengguna yang menjelaskan kesalahan atau status operasional.

Operasi

Jenis data: string
Jenis akses: Baca-saja

Operasi yang terjadi pada saat kegagalan atau anomali. Biasanya, Instrumentasi Manajemen Windows (WMI) mengatur properti ini ke nama COM API untuk metode WMI seperti berikut: IWbemServices::CreateInstanceEnum.

ParameterInfo

Jenis data: string
Jenis akses: Baca-saja

Parameter yang terlibat dalam kesalahan atau perubahan status. Misalnya, jika aplikasi mencoba mengambil kelas yang tidak ada, properti ini diatur ke nama kelas yang menyinggung.

ProviderName

Jenis data: string
Jenis akses: Baca-saja

Mengidentifikasi penyedia yang menyebabkan atau melaporkan perubahan kesalahan atau status. Jika penyedia tidak terlibat, string ini diatur ke "Manajemen Windows".

StatusCode

Jenis data: uint32
Jenis akses: Baca-saja

Berisi kesalahan atau kode informasi untuk operasi. Ini dapat berupa nilai apa pun yang ditentukan oleh penyedia, tetapi nilai 0 (nol) biasanya dicadangkan untuk menunjukkan keberhasilan. Properti ini diwariskan dari __NotifyStatus.

Keterangan

Kelas __ExtendedStatus berasal dari kelas __NotifyStatus.

Gunakan kelas __ExtendedStatus untuk melaporkan informasi yang lebih kompleks daripada kode hasil sederhana. Penyedia dapat memperoleh kelas mereka sendiri dari __ExtendedStatus jika mereka memerlukan lebih banyak properti untuk menjelaskan kesalahan.

Properti StatusCode , yang diwarisi dari kelas induk __NotifyStatus , adalah bilangan bulat yang tidak ditandatangani yang mewakili nilai kesalahan atau status. Ketika instans kelas ini dikembalikan dari metode oleh penyedia dinamis, properti StatusCode dan Description diatur oleh penyedia, dan properti lainnya diatur oleh WMI.

Contoh

Contoh kode VBScript berikut menjelaskan penggunaan __ExtendedStatus untuk mengambil informasi kesalahan.

Sub sink_OnCompleted(HResult, oErr, oCtx) 
    WScript.Echo "All collections returned" 
  
    if HResult <> 0 Then  
    ' Determine the type of error. 
        If oErr.Path_.Class = "__ExtendedStatus" Then 
            WScript.Echo "WMI Error: "& oErr.Description             
        ElseIf ExtendedStatus.Path_.Class = "SMS_ExtendedStatus" Then 
            WScript.Echo "Provider Error: "& oErr.Description 
            WScript.Echo "Code: " & oErr.ErrorCode 
        End If 
    End If     
    bdone = true 
End sub

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista
Server minimum yang didukung	Windows Server 2008
Ruang nama	Semua namespace layanan WMI

Bagikan melalui