Metode Properti IADsService
Metode properti antarmuka IADsService membaca dan menulis properti yang dijelaskan dalam topik ini. Untuk informasi selengkapnya, lihat Metode Properti Antarmuka.
Properti
-
Dependensi
-
-
Jenis akses: Baca/tulis
-
Jenis data pembuatan skrip: VARIAN
-
// C++ method syntax HRESULT get_Dependencies( [out] VARIANT* pvServiceDepend ); HRESULT put_Dependencies( [in] VARIANT vServiceDepend );
Array nama BSTR layanan atau grup beban yang harus dimuat agar layanan ini dapat dimuat. Sintaks untuk entri adalah "Service:" diikuti dengan nama layanan atau "Group:" diikuti dengan nama grup beban.
-
-
DisplayName
-
-
Jenis akses: Baca/tulis
-
Jenis data pembuatan skrip: BSTR
-
// C++ method syntax HRESULT get_DisplayName( [out] BSTR* pbstrDisplayName ); HRESULT put_DisplayName( [in] BSTR bstrDisplayName );
Nama layanan yang ramah.
-
-
ErrorControl
-
-
ADS_SERVICE_ERROR_IGNORE
-
Program startup mencatat kesalahan, tetapi melanjutkan operasi startup.
-
ADS_SERVICE_ERROR_NORMAL
-
Program startup mencatat kesalahan dan menyajikan kotak pesan, tetapi melanjutkan operasi startup.
-
ADS_SERVICE_ERROR_SEVERE
-
Program startup mencatat kesalahan. Jika konfigurasi terakhir yang diketahui baik dimulai, operasi startup berlanjut. Jika tidak, sistem dimulai ulang dengan konfigurasi terakhir yang diketahui baik.
-
ADS_SERVICE_ERROR_CRITICAL
-
Program startup mencatat kesalahan, jika memungkinkan. Jika konfigurasi terakhir yang diketahui baik sedang dimulai, operasi startup gagal. Jika tidak, sistem dimulai ulang dengan konfigurasi baik yang terakhir diketahui.
Tindakan yang akan dilakukan jika layanan ini gagal pada startup. Berikut ini adalah nilai yang valid untuk properti ini.
-
-
Jenis akses: Baca/tulis
-
Jenis data pembuatan skrip: LONG
-
// C++ method syntax HRESULT get_ErrorControl( [out] LONG* plErrorControl ); HRESULT put_ErrorControl( [in] LONG lErrorControl );
HostComputer
-
Jenis akses: Baca/tulis
-
Jenis data pembuatan skrip: BSTR
-
// C++ method syntax HRESULT get_HostComputer( [out] BSTR* pbstrHostComputer ); HRESULT put_HostComputer( [in] BSTR bstrHostComputer );
String ADsPath dari host layanan ini.
LoadOrderGroup
-
Jenis akses: Baca/tulis
-
Jenis data pembuatan skrip: BSTR
-
// C++ method syntax HRESULT get_LoadOrderGroup( [out] BSTR* pbstrLoadOrderGroup ); HRESULT put_LoadOrderGroup( [in] BSTR bstrLoadOrderGroup );
Nama grup pesanan beban yang merupakan anggota layanan ini.
Jalur
-
Jenis akses: Baca/tulis
-
Jenis data pembuatan skrip: BSTR
-
// C++ method syntax HRESULT get_Path( [out] BSTR* pbstrPath ); HRESULT put_Path( [in] BSTR bstrPath );
Jalur dan nama file ke executable layanan ini.
ServiceAccountName
-
Jenis akses: Baca/tulis
-
Jenis data pembuatan skrip: BSTR
-
// C++ method syntax HRESULT get_ServiceAccountName( [out] BSTR* pbstrServiceAccountName ); HRESULT put_ServiceAccountName( [in] BSTR bstrServiceAccountName );
Nama akun yang digunakan layanan ini untuk mengautentikasi dirinya sendiri saat startup.
ServiceAccountPath
-
Jenis akses: Baca/tulis
-
Jenis data pembuatan skrip: BSTR
-
// C++ method syntax HRESULT get_ServiceAccountPath( [out] BSTR* pbstrServiceAccountPath ); HRESULT put_ServiceAccountPath( [in] BSTR bstrServiceAccountPath );
Jalur akun yang ditentukan oleh properti ServiceAccountPath .
ServiceType
-
ADS_SERVICE_KERNEL_DRIVER (0x00000001)
-
ADS_SERVICE_FILE_SYSTEM_DRIVER (0x00000002)
-
ADS_SERVICE_OWN_PROCESS (0x00000010)
-
ADS_SERVICE_SHARE_PROCESS (0x00000020)
Deskripsi tentang bagaimana layanan menyajikan dirinya sendiri di komputer host. Properti ini bisa berupa nol atau kombinasi dari satu atau beberapa nilai berikut.
Jenis akses: Baca/tulis
Jenis data pembuatan skrip: LONG
// C++ method syntax
HRESULT get_ServiceType(
[out] LONG* plServiceType
);
HRESULT put_ServiceType(
[in] LONG lServiceType
);
StartType
-
ADS_SERVICE_BOOT_START
-
Layanan ini adalah driver perangkat yang dimulai oleh pemuat sistem. Nilai ini hanya berlaku untuk layanan driver.
-
ADS_SERVICE_SYSTEM_START
-
Layanan ini adalah driver perangkat yang dimulai oleh fungsi IoInitSystem . Nilai ini hanya berlaku untuk layanan driver.
-
ADS_SERVICE_AUTO_START
-
Layanan akan dimulai secara otomatis oleh manajer kontrol layanan selama startup sistem.
-
ADS_SERVICE_DEMAND_START
-
Layanan akan dimulai oleh manajer kontrol layanan ketika proses memanggil fungsi StartService .
-
ADS_SERVICE_DISABLED
-
Layanan tidak dapat dimulai. Upaya untuk memulai layanan menghasilkan kode kesalahan ERROR_SERVICE_DISABLED.
Menentukan cara memulai layanan. Berikut ini adalah nilai yang valid untuk properti ini.
Jenis akses: Baca/tulis
Jenis data pembuatan skrip: LONG
// C++ method syntax
HRESULT get_StartType(
[out] LONG* plStartType
);
HRESULT put_StartType(
[in] LONG lStartType
);
StartupParameters
-
Jenis akses: Baca/tulis
-
Jenis data pembuatan skrip: BSTR
-
// C++ method syntax HRESULT get_StartupParameters( [out] BSTR* pbstrStartupParameters ); HRESULT put_StartupParameters( [in] BSTR bstrStartupParameters );
Parameter yang diteruskan ke layanan saat startup.
Versi
-
Jenis akses: Baca/tulis
-
Jenis data pembuatan skrip: BSTR
-
// C++ method syntax HRESULT get_Version( [out] BSTR* pbstrVersion ); HRESULT put_Version( [in] BSTR bstrVersion );
Versi layanan.
Contoh
Contoh kode berikut menunjukkan cara mencantumkan semua layanan sistem yang tersedia yang berjalan di komputer host, "myMachine", bersama dengan lokasi untuk menemukan executable layanan.
Dim cp As IADsComputer
On Error GoTo Cleanup
Set cp = GetObject("WinNT://myMachine,computer")
If (IsEmpty(cp) = False) Then
cp.Filter = Array("Service")
For Each service In cp
MsgBox service.Name & " @" & service.path
Next
End if
Cleanup:
If (Err.Number<>0) Then
MsgBox("An error has occurred. " & Err.Number)
End If
Set cp = Nothing
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung |
Windows Vista |
Server minimum yang didukung |
Windows Server 2008 |
Header |
|
DLL |
|
IID |
IID_IADsService didefinisikan sebagai 68AF66E0-31CA-11CF-A98A-00AA006BC149 |