docs: add bilingual README (EN/IT)
This commit is contained in:
Simone
+175
@@ -0,0 +1,175 @@
|
||||
# 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.*
|
||||
Reference in New Issue
Block a user