WSMAN_PLUGIN_SHUTDOWN fungsi panggilan balik (wsman.h)

  • Artikel

Menentukan panggilan balik matikan untuk plug-in. Fungsi ini dipanggil setelah semua operasi dibatalkan dan sebelum DLL plug-in Windows Remote Management dibongkar. Semua plug-in WinRM harus menerapkan fungsi panggilan balik ini.

Nama titik entri DLL harus WSManPluginShutdown.

Sintaks

WSMAN_PLUGIN_SHUTDOWN WsmanPluginShutdown;

DWORD WsmanPluginShutdown(
  PVOID pluginContext,
  DWORD flags,
  DWORD reason
)
{...}

Parameter

pluginContext

Menentukan konteks yang dikembalikan oleh panggilan ke metode WSManPluginStartup . Parameter ini mewakili inisialisasi aplikasi tertentu dari plug-in WinRM. Titik entri matikan akan dipanggil untuk setiap aplikasi yang menginisialisasinya.

flags

Disiapkan untuk penggunaan masa mendatang. Harus diatur ke nol.

reason

Menentukan alasan plug-in dimatikan.

WSMAN_PLUGIN_SHUTDOWN_SYSTEM

Sistem dimatikan.

WSMAN_PLUGIN_SHUTDOWN_SERVICE

Layanan WinRM dimatikan.

WSMAN_PLUGIN_SHUTDOWN_IISHOST

Host IIS dimatikan.

Nilai kembali

Metode mengembalikan NO_ERROR jika berhasil; jika tidak, kode kesalahan akan dikembalikan.

Catatan Jika metode ini gagal, plug-in tidak akan memanggil kembali.
 

Keterangan

Setiap panggilan yang berhasil ke WSManPluginStartup akan menghasilkan panggilan ke fungsi ini sebelum DLL plug-in WinRM dibongkar. Penting untuk memastikan bahwa plug-in WinRM melacak berapa kali titik entri startup ini dipanggil sehingga plug-in tidak dimatikan sebelum waktunya.

Fungsi ini harus memastikan bahwa semua utas plug-in dimatikan sebelum kembali. Jika plug-in hanya menangani operasi sinkron dan semua utas melaporkan hasil pembatalan sebelum kembali, fungsi ini hanya melakukan pembersihan plug-in. Namun, untuk plug-in asinkron, utas apa pun yang digunakan untuk memproses utas plug-in, termasuk yang baru saja melaporkan pembatalan untuk semua operasi, perlu dimatikan sepenuhnya. Jika semua utas tidak dimatikan, crash di DLL mungkin terjadi karena kode mungkin dijalankan setelah DLL dibongkar.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 7
Server minimum yang didukung Windows Server 2008 R2
Target Platform Windows
Header wsman.h
Redistribusi Windows Management Framework pada Windows Server 2008 dengan SP2, , dan Windows Vista dengan SP2