Plik nagłówkowy Multi-User

1. Wprowadzenie

Nowoczesne systemy Windows obsługują konta wielu użytkowników na jednym komputerze, każde z innymi uprawnieniami. Z powodów bezpieczeństwa, uprawnienia aplikacji również są ograniczone. Z punktu widzenia instalatora, ważne są: poziom wykonania oraz tryb instalacji. Poziom wykonania określa uprawnienia dla instalatora. Na przykład, aby zainstalować sterowniki urządzeń, wymagane są uprawnienia administratora. Programy mogą być również instalowane dla pojedynczego użytkownika lub dla wszystkich użytkowników komputera. Określa to tryb instalacji. Instalacja dla wszystkich użytkowników wymaga wyższych uprawnień w porównaniu z trybem instalacji dla pojedynczego użytkownika. Plik nagłówkowy MultiUser.nsh umożliwia automatyczną obsługę opisywanych aspektów procesu instalacji, to jest obsługę kont użytkowników oraz uprawnień.

Proszę zwrócić uwagę, że wszystkie ustawienia muszą być ustalone przed dołączeniem pliku nagłówkowego MultiUser.nsh.

2. Inicjalizacja i poziom wykonywania

Przed dołączeniem pliku nagłówkowego MultiUser.nsh, powinna być określona definicja MULTIUSER_EXECUTIONLEVEL. Przyjmować może ona jedną z poniższych wartości, w zależności od wymaganego poziomu wykonania:

Aby zweryfikować te uprawnienia, wstaw makra MULTIUSER_INIT oraz MULTIUSER_UNINT w funkcji .onInit oraz un.onInit. Jeśli nie jest tworzony deinstalator, ustaw definicję MULTIUSER_NOUNINSTALL.

!define MULTIUSER_EXECUTIONLEVEL Highest
; !define MULTIUSER_NOUNINSTALL ; Odkomentuj tę linię, jeśli deinstalator nie jest tworzony
!include MultiUser.nsh

...

Function .onInit
  !insertmacro MULTIUSER_INIT
FunctionEnd

Function un.onInit
  !insertmacro MULTIUSER_UNINIT
FunctionEnd

To, czy wymagane uprawnienia mogą być pobrane zależy od użytkownika, który uruchamia instalatora:

Zaleca się wstawienie inicjujących makr przed makrami, które wymagają interwencji użytkownika. Na przykład, nie ma sensu pytać użytkownika o język instalatora, jeśli instalator zakończy pracę, ponieważ konto użytkownika nie posiada odpowiednich uprawnień. Po wstawieniu tych makr, zmienna $MultiUser.Privileges będzie zawierała poziom wykonania bieżącego użytkownika (Admin, Power, User lub Guest).

Dostępne są poniższe dodatkowe ustawienia dla inicjalizacji:

3. Tryb instalacji

Jak wcześniej wspomniano, aplikacje mogą być instalowane zarówno dla pojedynczego użytkownika, jak i dla wszystkich użytkowników komputera. Aplikacje dla wszystkich użytkowników zazwyczaj instalowane są w katalogu 'Program Files' i pojawiają się w menu Start każdego użytkownika komputera. Aplikacje dla pojedynczego użytkownika zaś, są zazwyczaj instalowane w lokalnym katalogu danych aplikacji i pojawiają się w menu Start użytkownika, który zainstalował aplikację.

Domyślnie, plik nagłówkowy MultiUser.nsh ustawia tryb instalacji na tryb instalacji dla wszystkich użytkowników, jeśli dostępne są uprawnienia administratora lub użytkownika zaawansowanego (dzieje się tak zawsze, gdy poziom wykonania ustawiony jest na uprawnienia administratora Admin lub użytkownika zaawansowanego Power. Poziom wykonania z najwyższymi dostępnymi uprawnieniami użytkownika Highest zależy od konta użytkownika). Dla standardowego poziomu wykonania instalacja zawsze będzie trybem instalacji pojedynczego użytkownika. W systemie Windows 95/98/Me instalacja dla pojedynczego użytkownika nie jest dostępna (zostanie przeprowadzona instalacja dla wszystkich użytkowników komputera).

Dostępne są następujące ustawienia do zmiany domyślnego trybu instalacji:

Po inicjalizacji, zmienna $MultiUser.InstallMode zawierać będzie bieżący tryb instalacji (AllUsers lub CurrentUser).

!define MULTIUSER_EXECUTIONLEVEL Highest
!define MULTIUSER_MUI
!define MULTIUSER_INSTALLMODE_COMMANDLINE
!include MultiUser.nsh
!include MUI2.nsh

!insertmacro MULTIUSER_PAGE_INSTALLMODE
!insertmacro MUI_PAGE_DIRECTORY
!insertmacro MUI_PAGE_INSTFILES

!insertmacro MUI_LANGUAGE Polish

...

Function .onInit
  !insertmacro MULTIUSER_INIT
FunctionEnd

Function un.onInit
  !insertmacro MULTIUSER_UNINIT
FunctionEnd

4. Przykład

Podstawowy: "/Examples/MultiUser.nsi"