Simone
176 lines
4.8 KiB
Markdown
176 lines
4.8 KiB
Markdown
# nsProcess NSIS Plugin v1.6
|
|
|
|
**Versione personale modificata**
|
|
|
|
---
|
|
|
|
## Descrizione Originale
|
|
|
|
**2006 Shengalts Aleksander aka Instructor (Shengalts@mail.ru)**
|
|
|
|
Funzione sorgente FIND_PROC_BY_NAME basata sul codice di Ravi Kochhar (kochhar@physiology.wisc.edu).
|
|
Grazie a iceman_k (plugin FindProcDLL) e DITMan (plugin KillProcDLL) per l'ispirazione.
|
|
Versione NSIS UNICODE compatibile (1.6) di brainsucker.
|
|
|
|
## Funzionalità
|
|
|
|
- Cerca un processo per nome
|
|
- Termina tutti i processi con il nome specificato (non solo uno)
|
|
- Chiude tutti i processi con il nome specificato (prima tenta di chiudere le finestre, attende 3 secondi, poi termina se ancora attivo)
|
|
- Il nome del processo non è case-sensitive
|
|
- Supporto Win95/98/ME/NT/2000/XP/Win7
|
|
- Dimensione plugin ridotta (4 Kb)
|
|
- Supporto NSIS UNICODE
|
|
|
|
## Utilizzo
|
|
|
|
### Ricerca processo
|
|
|
|
```nsis
|
|
${nsProcess::FindProcess} "[file.exe]" $var
|
|
```
|
|
|
|
**Parametri:**
|
|
- `[file.exe]` - Nome processo (es. "notepad.exe")
|
|
|
|
**Valori restituiti ($var):**
|
|
| Codice | Descrizione |
|
|
|--------|-------------|
|
|
| 0 | Successo |
|
|
| 603 | Processo non in esecuzione |
|
|
| 604 | Impossibile identificare il tipo di sistema |
|
|
| 605 | OS non supportato |
|
|
| 606 | Impossibile caricare NTDLL.DLL |
|
|
| 607 | Impossibile ottenere l'indirizzo della procedura da NTDLL.DLL |
|
|
| 608 | NtQuerySystemInformation fallita |
|
|
| 609 | Impossibile caricare KERNEL32.DLL |
|
|
| 610 | Impossibile ottenere l'indirizzo della procedura da KERNEL32.DLL |
|
|
| 611 | CreateToolhelp32Snapshot fallita |
|
|
|
|
### Terminazione/Chiusura processo
|
|
|
|
```nsis
|
|
${nsProcess::KillProcess} "[file.exe]" $var
|
|
${nsProcess::CloseProcess} "[file.exe]" $var
|
|
```
|
|
|
|
**Valori restituiti ($var):**
|
|
| Codice | Descrizione |
|
|
|--------|-------------|
|
|
| 0 | Successo |
|
|
| 601 | Permessi insufficienti per terminare il processo |
|
|
| 602 | Non tutti i processi sono stati terminati |
|
|
| 603 | Processo non in esecuzione |
|
|
| 604 | Impossibile identificare il tipo di sistema |
|
|
| 605 | OS non supportato |
|
|
| ... | (vedi sopra) |
|
|
|
|
### Chiamata diretta al plugin (senza macro)
|
|
|
|
```nsis
|
|
nsProcess::_CloseProcess "notepad.exe"
|
|
Pop $R0
|
|
```
|
|
|
|
### Scaricamento plugin
|
|
|
|
```nsis
|
|
${nsProcess::Unload}
|
|
```
|
|
|
|
## Esempio
|
|
|
|
```nsis
|
|
!include "nsProcess.nsh"
|
|
|
|
Section "Verifica Notepad"
|
|
${nsProcess::FindProcess} "notepad.exe" $R0
|
|
${If} $R0 == 0
|
|
MessageBox MB_YESNO "Notepad è in esecuzione. Chiuderlo?" IDNO skip
|
|
${nsProcess::CloseProcess} "notepad.exe" $R0
|
|
${If} $R0 == 0
|
|
MessageBox MB_OK "Notepad chiuso con successo"
|
|
${Else}
|
|
MessageBox MB_OK "Impossibile chiudere Notepad"
|
|
${EndIf}
|
|
skip:
|
|
${Else}
|
|
MessageBox MB_OK "Notepad non è in esecuzione"
|
|
${EndIf}
|
|
${nsProcess::Unload}
|
|
SectionEnd
|
|
```
|
|
|
|
## File include
|
|
|
|
Includi `nsProcess.nsh` per utilizzare le macro:
|
|
|
|
```nsis
|
|
!include "nsProcess.nsh"
|
|
```
|
|
|
|
---
|
|
|
|
## ⚠️ Differenze nella versione personale
|
|
|
|
### Nuova architettura supportata: x64 (amd64-unicode)
|
|
|
|
L'originale supportava solo:
|
|
- x86-ansi (Plugins\nsProcess.dll)
|
|
- x86-unicode (nsProcessW.dll da rinominare in nsProcess.dll)
|
|
|
|
La versione personale aggiunge il supporto per:
|
|
- **amd64-unicode** (x64)
|
|
|
|
### Progetto Visual Studio
|
|
|
|
L'originale includeva:
|
|
- `Source/nsProcess.sln` - Solution VS2008
|
|
- `Source/nsProcess.vcproj` - Progetto VS2008 (solo x86)
|
|
|
|
La versione personale converte a VS2022 con supporto x64:
|
|
- `nsProcess.sln` - Solution VS2022
|
|
- `nsProcess/nsProcess.vcxproj` - Progetto VS2022 (x86-ansi, x86-unicode, amd64-unicode)
|
|
|
|
### File aggiunti
|
|
|
|
- `build_plugin.py` - Script Python per compilare il plugin per tutte le architetture
|
|
- `nsis/` - Cartella con gli header NSIS per la compilazione:
|
|
- `api.h`, `crt.c`, `nsis_tchar.h`, `pluginapi.c`, `pluginapi.h`
|
|
|
|
### File rimossi
|
|
|
|
I file DLL precompilati sono stati rimossi dalla distribuzione:
|
|
|
|
- `Plugins/nsProcess.dll` (x86 ANSI)
|
|
- `nsProcessW.dll` (x86 UNICODE)
|
|
|
|
### Compilazione
|
|
|
|
```cmd
|
|
cd nsProcess
|
|
python build_plugin.py
|
|
```
|
|
|
|
I DLL vengono copiati in `plugins/{platform}/nsProcess.dll`.
|
|
|
|
### Opzioni build
|
|
|
|
```powershell
|
|
python build_plugin.py --config x86-unicode # Solo un'architettura (x86-ansi|x86-unicode|amd64-unicode|all)
|
|
python build_plugin.py --toolset 2026 # Toolset specifico (2022|2026|auto)
|
|
python build_plugin.py --jobs 4 # Numero di job MSBuild paralleli (default: CPU count)
|
|
python build_plugin.py --clean # Pulizia dist/ prima della build
|
|
python build_plugin.py --install-dir "C:\NSIS\Plugins" # Copia in directory NSIS aggiuntiva
|
|
python build_plugin.py --verbose # Output MSBuild esteso
|
|
python build_plugin.py --version # Stampa versione ed esce
|
|
```
|
|
|
|
### Modifiche funzionali
|
|
|
|
Nessuna modifica funzionale rispetto all'originale. Le modifiche riguardano solo l'infrastruttura di build e il supporto x64.
|
|
|
|
---
|
|
|
|
*See [README.md](README.md) for the English version.*
|