struktur SERVICE_NOTIFY_2A (winsvc.h)

Artikel
03/13/2024

Mewakili informasi pemberitahuan status layanan. Ini digunakan oleh fungsi NotifyServiceStatusChange .

Sintaks

typedef struct _SERVICE_NOTIFY_2A {
  DWORD                  dwVersion;
  PFN_SC_NOTIFY_CALLBACK pfnNotifyCallback;
  PVOID                  pContext;
  DWORD                  dwNotificationStatus;
  SERVICE_STATUS_PROCESS ServiceStatus;
  DWORD                  dwNotificationTriggered;
  LPSTR                  pszServiceNames;
} SERVICE_NOTIFY_2A, *PSERVICE_NOTIFY_2A;

Anggota

dwVersion

Versi struktur. Anggota ini harus SERVICE_NOTIFY_STATUS_CHANGE (2).

pfnNotifyCallback

Penunjuk ke fungsi panggilan balik. Untuk informasi selengkapnya, lihat Keterangan.

pContext

Setiap data yang ditentukan pengguna untuk diteruskan ke fungsi panggilan balik.

dwNotificationStatus

Nilai yang menunjukkan status pemberitahuan. Jika anggota ini ERROR_SUCCESS, pemberitahuan telah berhasil dan anggota ServiceStatus berisi informasi yang valid. Jika anggota ini ERROR_SERVICE_MARKED_FOR_DELETE, layanan telah ditandai untuk penghapusan dan handel layanan yang digunakan oleh NotifyServiceStatusChange harus ditutup.

ServiceStatus

Struktur SERVICE_STATUS_PROCESS yang berisi informasi status layanan. Anggota ini hanya valid jika dwNotificationStatusERROR_SUCCESS.

dwNotificationTriggered

Jika dwNotificationStatusERROR_SUCCESS, anggota ini berisi bitmask pemberitahuan yang memicu panggilan ini ke fungsi panggilan balik.

pszServiceNames

Jika dwNotificationStatusERROR_SUCCESS dan pemberitahuan SERVICE_NOTIFY_CREATED atau SERVICE_NOTIFY_DELETED, anggota ini valid dan merupakan string MULTI_SZ yang berisi satu atau beberapa nama layanan. Nama layanan yang dibuat akan memiliki awalan '/' sehingga Anda dapat membedakannya dari nama layanan yang dihapus.

Jika anggota ini valid, fungsi panggilan balik pemberitahuan harus membebaskan string menggunakan fungsi LocalFree .

Keterangan

Fungsi panggilan balik dinyatakan sebagai berikut:

typedef VOID( CALLBACK * PFN_SC_NOTIFY_CALLBACK ) (
    IN PVOID pParameter 
);

Fungsi panggilan balik menerima penunjuk ke struktur SERVICE_NOTIFY yang disediakan oleh pemanggil.

Catatan

Header winsvc.h mendefinisikan SERVICE_NOTIFY_2 sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Header	winsvc.h (sertakan Windows.h)

Lihat juga

NotifyServiceStatusChange

SERVICE_STATUS_PROCESS

Bagikan melalui