Java Native Access Platform 5.14.0 · com.sun.jna.platform.win32.W32ServiceManager

Modifier and Type	Field and Description
pack-priv String	_databaseName
pack-priv Winsvc.SC_HANDLE	_handle
pack-priv String	_machineName

Constructor Summary

Access	Constructor and Description
public	W32ServiceManager() Instantiate a W32ServiceManager for the local computer and the SERVICES_ACTIVE_DATABASE ("ServicesActive") database.
public	W32ServiceManager(int requested permissions for access permissions) Instantiate a W32ServiceManager for the local computer and the SERVICES_ACTIVE_DATABASE ("ServicesActive") database.
public	W32ServiceManager(String The name of the target computer. If the pointer is NULL or points to an empty string, the function connects to the service control manager on the local computer. machineName, String The name of the service control manager database. This parameter should be set to "ServicesActive". If it is NULL, the "ServicesActive" (SERVICES_ACTIVE_DATABASE) database is opened by default. The connection is not established until `open(int)` is called. databaseName) Instantiate a W32ServiceManager.
public	W32ServiceManager(String The name of the target computer. If the pointer is NULL or points to an empty string, the function connects to the service control manager on the local computer. machineName, String The name of the service control manager database. This parameter should be set to "ServicesActive". If it is NULL, the "ServicesActive" (SERVICES_ACTIVE_DATABASE) database is opened by default. databaseName, int requested permissions for access permissions) Instantiate a W32ServiceManager.

Method Summary

Modifier and Type Method and Description

public void

close()

Implements java.io.Closeable.close.

Closes the previously opened Service Manager.

public Winsvc.ENUM_SERVICE_STATUS_PROCESS[]

Returns:

array of ENUM_SERVICE_STATUS_PROCESS structures.

enumServicesStatusExProcess(int

The type of services to be enumerated. This parameter can be one or more of the following values.

Value	Meaning
`WinNT#SERVICE_DRIVER`	Services of type `WinNT#SERVICE_KERNEL_DRIVER` and `WinNT#SERVICE_FILE_SYSTEM_DRIVER`.
`WinNT#SERVICE_FILE_SYSTEM_DRIVER`	File system driver services.
`WinNT#SERVICE_KERNEL_DRIVER`	Driver services.
`WinNT#SERVICE_WIN32`	Services of type `WinNT#SERVICE_WIN32_OWN_PROCESS` and `WinNT#SERVICE_WIN32_SHARE_PROCESS`.
`WinNT#SERVICE_WIN32_OWN_PROCESS`	Services that run in their own processes.
`WinNT#SERVICE_WIN32_SHARE_PROCESS`	Services that share a process with one or more other services. For more information, see Service Programs.

dwServiceType, int

The state of the services to be enumerated. This parameter can be one of the following values.

Value	Meaning
`Winsvc#SERVICE_ACTIVE`	Enumerates services that are in the following states: `Winsvc#SERVICE_START_PENDING`, `Winsvc#SERVICE_STOP_PENDING`, `Winsvc#SERVICE_RUNNING`, `Winsvc#SERVICE_CONTINUE_PENDING`, `Winsvc#SERVICE_PAUSE_PENDING`, and `Winsvc#SERVICE_PAUSED`.
`Winsvc#SERVICE_INACTIVE`	Enumerates services that are in the `Winsvc#SERVICE_STOPPED` state.
`Winsvc#SERVICE_STATE_ALL`	Combines the following states: `Winsvc#SERVICE_ACTIVE` and `Winsvc#SERVICE_INACTIVE`.

dwServiceState, String

The load-order group name. If this parameter is a string, the only services enumerated are those that belong to the group that has the name specified by the string. If this parameter is an empty string, only services that do not belong to any group are enumerated. If this parameter is NULL, group membership is ignored and all services are enumerated.

groupName)

Enumerates services in the specified service control manager database.

public Winsvc.SC_HANDLE

Returns:

Returns the service manager handle.

getHandle()

Gets the service manager handle.

public void

open(int

Permissions.

permissions)

(Re-)Opens the Service Manager with the supplied permissions.

public W32Service

Returns:

Returns an opened service.

openService(String

Service name.

serviceName, int

Permissions.

permissions)

Opens a Service.

Inherited from java.lang.Object:: clone equals finalize getClass hashCode notify notifyAll toString wait wait wait

Field Detail

_databaseName	back to summary
pack-priv String _databaseName

_handle	back to summary
pack-priv Winsvc.SC_HANDLE _handle

_machineName	back to summary
pack-priv String _machineName

Constructor Detail

W32ServiceManager back to summary

W32ServiceManager	back to summary
public W32ServiceManager() Instantiate a W32ServiceManager for the local computer and the SERVICES_ACTIVE_DATABASE ("ServicesActive") database. The connection is not established until `open(int)` is called.

public W32ServiceManager()

Instantiate a W32ServiceManager for the local computer and the SERVICES_ACTIVE_DATABASE ("ServicesActive") database.

The connection is not established until open(int) is called.

W32ServiceManager	back to summary
public W32ServiceManager(int permissions) Instantiate a W32ServiceManager for the local computer and the SERVICES_ACTIVE_DATABASE ("ServicesActive") database. A connection is opened directly with the requested permissions. Parameters permissions:int requested permissions for access

W32ServiceManager

back to summary

public W32ServiceManager(int permissions)

Instantiate a W32ServiceManager for the local computer and the SERVICES_ACTIVE_DATABASE ("ServicesActive") database.

A connection is opened directly with the requested permissions.

Parameters

permissions:int: requested permissions for access

W32ServiceManager back to summary

W32ServiceManager	back to summary
public W32ServiceManager(String machineName, String databaseName) Instantiate a W32ServiceManager. Parameters machineName:String The name of the target computer. If the pointer is NULL or points to an empty string, the function connects to the service control manager on the local computer. databaseName:String The name of the service control manager database. This parameter should be set to "ServicesActive". If it is NULL, the "ServicesActive" (SERVICES_ACTIVE_DATABASE) database is opened by default. The connection is not established until `open(int)` is called.

public W32ServiceManager(String machineName, String databaseName)

Instantiate a W32ServiceManager.

Parameters

machineName:String

The name of the target computer. If the pointer is NULL or points to an empty string, the function connects to the service control manager on the local computer.

databaseName:String

The name of the service control manager database. This parameter should be set to "ServicesActive". If it is NULL, the "ServicesActive" (SERVICES_ACTIVE_DATABASE) database is opened by default.

The connection is not established until open(int) is called.

W32ServiceManager	back to summary
public W32ServiceManager(String machineName, String databaseName, int permissions) Instantiate a W32ServiceManager. A connection is opened directly with the requested permissions. Parameters machineName:String The name of the target computer. If the pointer is NULL or points to an empty string, the function connects to the service control manager on the local computer. databaseName:String The name of the service control manager database. This parameter should be set to "ServicesActive". If it is NULL, the "ServicesActive" (SERVICES_ACTIVE_DATABASE) database is opened by default. permissions:int requested permissions for access

W32ServiceManager

back to summary

public W32ServiceManager(String machineName, String databaseName, int permissions)

Instantiate a W32ServiceManager.

A connection is opened directly with the requested permissions.

Parameters

machineName:String: The name of the target computer. If the pointer is NULL or points to an empty string, the function connects to the service control manager on the local computer.
databaseName:String: The name of the service control manager database. This parameter should be set to "ServicesActive". If it is NULL, the "ServicesActive" (SERVICES_ACTIVE_DATABASE) database is opened by default.
permissions:int: requested permissions for access

Method Detail

close	back to summary
public void close() Implements java.io.Closeable.close. Closes the previously opened Service Manager. Annotations @Override

back to summary

public void close()

Implements java.io.Closeable.close.

Closes the previously opened Service Manager.

Annotations

@Override

enumServicesStatusExProcess back to summary

public Winsvc.ENUM_SERVICE_STATUS_PROCESS[] enumServicesStatusExProcess(int dwServiceType, int dwServiceState, String groupName)

Enumerates services in the specified service control manager database. The name and status of each service are provided, along with additional data based on the specified information level.

Parameters

dwServiceType:int

The type of services to be enumerated. This parameter can be one or more of the following values.

Value	Meaning
`WinNT#SERVICE_DRIVER`	Services of type `WinNT#SERVICE_KERNEL_DRIVER` and `WinNT#SERVICE_FILE_SYSTEM_DRIVER`.
`WinNT#SERVICE_FILE_SYSTEM_DRIVER`	File system driver services.
`WinNT#SERVICE_KERNEL_DRIVER`	Driver services.
`WinNT#SERVICE_WIN32`	Services of type `WinNT#SERVICE_WIN32_OWN_PROCESS` and `WinNT#SERVICE_WIN32_SHARE_PROCESS`.
`WinNT#SERVICE_WIN32_OWN_PROCESS`	Services that run in their own processes.
`WinNT#SERVICE_WIN32_SHARE_PROCESS`	Services that share a process with one or more other services. For more information, see Service Programs.

dwServiceState:int

The state of the services to be enumerated. This parameter can be one of the following values.

Value	Meaning
`Winsvc#SERVICE_ACTIVE`	Enumerates services that are in the following states: `Winsvc#SERVICE_START_PENDING`, `Winsvc#SERVICE_STOP_PENDING`, `Winsvc#SERVICE_RUNNING`, `Winsvc#SERVICE_CONTINUE_PENDING`, `Winsvc#SERVICE_PAUSE_PENDING`, and `Winsvc#SERVICE_PAUSED`.
`Winsvc#SERVICE_INACTIVE`	Enumerates services that are in the `Winsvc#SERVICE_STOPPED` state.
`Winsvc#SERVICE_STATE_ALL`	Combines the following states: `Winsvc#SERVICE_ACTIVE` and `Winsvc#SERVICE_INACTIVE`.

groupName:String

Returns:Winsvc.ENUM_SERVICE_STATUS_PROCESS[]

array of ENUM_SERVICE_STATUS_PROCESS structures.

getHandle	back to summary
public Winsvc.SC_HANDLE getHandle() Gets the service manager handle. Returns:Winsvc.SC_HANDLE Returns the service manager handle.

getHandle

back to summary

public Winsvc.SC_HANDLE getHandle()

Gets the service manager handle.

Returns:Winsvc.SC_HANDLE: Returns the service manager handle.

open	back to summary
public void open(int permissions) (Re-)Opens the Service Manager with the supplied permissions. Parameters permissions:int Permissions.

open

back to summary

public void open(int permissions)

(Re-)Opens the Service Manager with the supplied permissions.

Parameters

permissions:int: Permissions.

openService	back to summary
public W32Service openService(String serviceName, int permissions) Opens a Service. Parameters serviceName:String Service name. permissions:int Permissions. Returns:W32Service Returns an opened service.

openService

back to summary

public W32Service openService(String serviceName, int permissions)

Opens a Service.

Parameters

serviceName:String: Service name.
permissions:int: Permissions.

Returns:W32Service

Returns an opened service.

public Class W32ServiceManager

Field Summary

Constructor Summary

Method Summary

Field Detail

Constructor Detail

Method Detail