xyz.cofe.win

Class WinApi

java.lang.Object

xyz.cofe.win.WinApi

public class WinApi
extends Object

Windows api

Constructor Summary

Constructors

Constructor and Description
WinApi()

Method Summary

Modifier and Type	Method and Description
static void	api(Consumer<WinApi> client) Выполнение кода в контексте wmi
static <R> R	api(Function<WinApi,R> client) Выполнение кода в контексте wmi
void	wmi(Consumer<Wmi> wmi) Соединение с wmi по умолчанию ,более детально см wmi(String, String, String, String, String, String, Consumer)
void	wmi(String host, Consumer<Wmi> client) Соединение с wmi по умолчанию, более детально см wmi(String, String, String, String, String, String, Consumer)
void	wmi(String host, String namespace, Consumer<Wmi> client) Соединение с wmi по умолчанию ,более детально см wmi(String, String, String, String, String, String, Consumer)
void	wmi(String host, String namespace, String user, String password, Consumer<Wmi> client) Соединение с wmi по умолчанию, более детально см wmi(String, String, String, String, String, String, Consumer)
void	wmi(String host, String namespace, String user, String password, String locale, Consumer<Wmi> client) Соединение с wmi по умолчанию, более детально см wmi(String, String, String, String, String, String, Consumer)
void	wmi(String host, String namespace, String user, String password, String locale, String authority, Consumer<Wmi> client) Работа с wmi api.
protected void	wmi0(String host, String namespace, String user, String password, String locale, String authority, Consumer<Wmi> client)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

WinApi

public WinApi()

Method Detail

api

public static void api(Consumer<WinApi> client)

Выполнение кода в контексте wmi

Parameters:

client - код

api

public static <R> R api(Function<WinApi,R> client)

Выполнение кода в контексте wmi

Parameters:

client - код

wmi

public void wmi(Consumer<Wmi> wmi)

Соединение с wmi по умолчанию ,более детально см wmi(String, String, String, String, String, String, Consumer)

Parameters:

wmi - клиентский код

wmi

public void wmi(String host,
                Consumer<Wmi> client)

Соединение с wmi по умолчанию, более детально см wmi(String, String, String, String, String, String, Consumer)

Parameters:

host - хост

client - клиентский код

wmi

public void wmi(String host,
                String namespace,
                Consumer<Wmi> client)

Соединение с wmi по умолчанию ,более детально см wmi(String, String, String, String, String, String, Consumer)

Parameters:

host - хост

namespace - пространство

client - клиентский код

wmi

public void wmi(String host,
                String namespace,
                String user,
                String password,
                Consumer<Wmi> client)

Соединение с wmi по умолчанию, более детально см wmi(String, String, String, String, String, String, Consumer)

Parameters:

host - хост

namespace - пространство

user - пользователь

password - пароль

client - клиентский код

wmi

public void wmi(String host,
                String namespace,
                String user,
                String password,
                String locale,
                Consumer<Wmi> client)

Соединение с wmi по умолчанию, более детально см wmi(String, String, String, String, String, String, Consumer)

Parameters:

host - хост

namespace - пространство

user - пользователь

password - пароль

locale - локаль

client - клиентский код

wmi

public void wmi(String host,
                String namespace,
                String user,
                String password,
                String locale,
                String authority,
                Consumer<Wmi> client)

Работа с wmi api.

Error codes

After the completion of the ConnectServer method, the Err object may contain one of the error codes in the following list.

• wbemErrAccessDenied - 2147749891 (0x80041003)

  The current or specified user name and password were not valid or authorized to make the connection.

• wbemErrFailed - 2147749889 (0x80041001)

  Unspecified error.

• wbemErrInvalidNamespace - 2147749902 (0x8004100E)

  The specified namespace did not exist on the server.

• wbemErrInvalidParameter - 2147749896 (0x80041008)

  An invalid parameter was specified, or the namespace could not be parsed.

• wbemErrOutOfMemory - 2147749894 (0x80041006)

  Not enough memory to complete the operation.

• wbemErrTransportFailure - 2147749909

  A networking error occurred, preventing normal operation.

Parameters:

host - хост, '.' - текущий хост.

Computer name to which you are connecting. If the remote computer is in a different domain than the user account under which you log in, then use the fully qualified computer name. If you do not provide this parameter, the call defaults to the local computer.

Example: server1.network.fabrikam

You also can use an IP address in this parameter. If the IP address is in IPv6 format, the target computer must be running IPv6. An address in IPv4 looks like 111.222.333.444

An IP address in IPv6 format looks like 2010:836B:4179::836B:4179

For more information on DNS and IPv4, see the Remarks section.

namespace - пространство имен wmi:

• 'ROOT\StandardCimv2' см MSFT_NetTCPConnection
• 'root\CIMV2' см Win32 Provider

String that specifies the namespace to which you log on. For example, to log on to the root\default namespace, use root\default. If you do not specify this parameter, it defaults to the namespace that is configured as the default namespace for scripting. For more information, see Creating a WMI Application or Script.

Example: "root\CIMV2"

user - User name to use to connect.

The string can be in the form of either a user name or a Domain\Username.

Leave this parameter blank to use the current security context.

The strUser parameter should only be used with connections to remote WMI servers.

If you attempt to specify strUser for a local WMI connection, the connection attempt fails.

If Kerberos authentication is in use, then the username and password that is specified in strUser and strPassword cannot be intercepted on a network.

You can use the UPN format to specify the strUser.

Example: "DomainName\UserName"

Note

If a domain is specified in strAuthority, then the domain must not be specified here. Specifying the domain in both parameters results in an Invalid Parameter error.

password - String that specifies the password to use when attempting to connect. Leave the parameter blank to use the current security context. The strPassword parameter should only be used with connections to remote WMI servers. If you attempt to specify strPassword for a local WMI connection, the connection attempt fails. If Kerberos authentication is in use then the username and password that is specified in strUser and strPassword cannot be intercepted on the network.

authority - String that specifies the localization code.

If you want to use the current locale, leave it blank.

If not blank, this parameter must be a string that indicates the desired locale where information must be retrieved.

For Microsoft locale identifiers, the format of the string is "MS_xxxx", where xxxx is a string in the hexadecimal form that indicates the LCID.

For example, American English would appear as "MS_409".

strAuthority [in, optional]

""

This parameter is optional. However, if it is specified, only Kerberos or NTLMDomain can be used.

Kerberos:

If the strAuthority parameter begins with the string "Kerberos:", then Kerberos authentication is used and this parameter should contain a Kerberos principal name.

The Kerberos principal name is specified as Kerberos:domain, such as Kerberos:fabrikam where fabrikam is the server to which you are attempting to connect.

Example: "Kerberos:DOMAIN"

NTLMDomain: To use NT Lan Manager (NTLM) authentication, you must specify it as NTLMDomain:domain, such as NTLMDomain:fabrikam where fabrikam is the name of the domain.

Example: "NTLMDomain:DOMAIN"

If you leave this parameter blank, the operating system negotiates with COM to determine whether NTLM or Kerberos authentication is used.

This parameter should only be used with connections to remote WMI servers.

If you attempt to set the authority for a local WMI connection, the connection attempt fails.

Note

If the domain is specified in strUser, which is the preferred location, then it must not be specified here. Specifying the domain in both parameters results in an Invalid Parameter error.

client - клиентский код

wmi0

protected void wmi0(String host,
                    String namespace,
                    String user,
                    String password,
                    String locale,
                    String authority,
                    Consumer<Wmi> client)