Module wmi

Convenience wrapper for displaying all manner of COM errors. Raises a x_wmi exception with more useful information attached

@param error_info The structure attached to a pywintypes.com_error

Convenience wrapper to take a series of date/time elements and return a WMI time of the form yyyymmddHHMMSS.mmmmmm+UUU. All elements may be int, string or omitted altogether. If omitted, they will be replaced in the output string by a series of stars of the appropriate length.

@param year The year element of the date/time @param month The month element of the date/time @param day The day element of the date/time @param hours The hours element of the date/time @param minutes The minutes element of the date/time @param seconds The seconds element of the date/time @param microseconds The microseconds element of the date/time @param timezone The timeezone element of the date/time

Convenience wrapper to take a WMI datetime string of the form yyyymmddHHMMSS.mmmmmm+UUU and return a 9-tuple containing the individual elements, or None where string contains placeholder stars.

@param wmi_time The WMI datetime string in yyyymmddHHMMSS.mmmmmm+UUU format

@return A 9-tuple of (year, month, day, hours, minutes, seconds, microseconds, timezone)

The WMI constructor can either take a ready-made moniker or as many parts of one as are necessary. Eg,

<pre class="code"> c = wmi.WMI (moniker="winmgmts:{impersonationLevel=Delegate}//remote")

# or

c = wmi.WMI (computer="remote", privileges=["!RemoteShutdown", "Security"]) </pre>

I daren't link to a Microsoft URL; they change so often. Try Googling for WMI construct moniker and see what it comes back with.

For complete control, a named argument "wmi" can be supplied, which should be a SWbemServices object, which you create yourself. Eg,

<pre class="code"> loc = win32com.client.Dispatch("WbemScripting.SWbemLocator") svc = loc.ConnectServer(...) c = wmi.WMI(wmi=svc) </pre>

This is the only way of connecting to a remote computer with a different username, as the moniker syntax does not allow specification of a user name.

If the "wmi" parameter is supplied, all other parameters are ignored.

The WMI constructor can either take a ready-made moniker or as many parts of one as are necessary. Eg,

<pre class="code"> c = wmi.WMI (moniker="winmgmts:{impersonationLevel=Delegate}//remote")

# or

c = wmi.WMI (computer="remote", privileges=["!RemoteShutdown", "Security"]) </pre>

I daren't link to a Microsoft URL; they change so often. Try Googling for WMI construct moniker and see what it comes back with.

For complete control, a named argument "wmi" can be supplied, which should be a SWbemServices object, which you create yourself. Eg,

<pre class="code"> loc = win32com.client.Dispatch("WbemScripting.SWbemLocator") svc = loc.ConnectServer(...) c = wmi.WMI(wmi=svc) </pre>

This is the only way of connecting to a remote computer with a different username, as the moniker syntax does not allow specification of a user name.

If the "wmi" parameter is supplied, all other parameters are ignored.

Return a remote server running WMI

  server - name of the server
  namespace - namespace to connect to: defaults to whatever's defined as default
  user - username to connect as, either local or domain (dom
ame or user@domain for XP)
  password: leave blank to use current context
  locale: desired locale in form MS_XXXX (eg MS_409 for Am En)
  authority: either "Kerberos:" or an NT domain. Not needed if included in user
  security_flags: if 0, connect will wait forever; if 0x80, connect will timeout at 2 mins
  named_value_set: typically empty, otherwise a context-specific SWbemNamedValueSet

  <pre class="code">
  c = wmi.WMI (wmi=wmi.connect_server (server="remote_machine", user="myname", password="mypassword"))
  </pre>
  

wbemFlagReturnImmediately

Value:

obj._constants.wbemFlagReturnImmediately

WMI_EXCEPTIONS

Value:

{wbemErrInvalidQuery: x_wmi_invalid_query, wbemErrTimedout: x_wmi_time d_out}