Class: WMI::Msft_Providers

Inherits:
Base
  • Object
show all
Defined in:
lib/Msft_Providers.rb

Overview

The Msft_Providers class exposes configuration relating to provider instances

Instance Method Summary (collapse)

Methods inherited from Base

#AddRef, #AssociatorsAsync_, #Associators_, #Clone_, #CompareTo_, #DeleteAsync_, #Delete_, #Derivation_, #ExecMethodAsync_, #ExecMethod_, #GetIDsOfNames, #GetObjectText_, #GetText_, #GetTypeInfo, #GetTypeInfoCount, #InstancesAsync_, #Instances_, #Invoke, #Methods_, #Path_, #Properties_, #PutAsync_, #Put_, #Qualifiers_, #QueryInterface, #ReferencesAsync_, #References_, #Refresh_, #Release, #Security_, #SetFromText_, #SpawnDerivedClass_, #SpawnInstance_, #SubclassesAsync_, #Subclasses_, #SystemProperties_

Instance Method Details

- (uint32) Load(Locale, Namespace, provider, TransactionIdentifier, User)

The Load method loads a specific instance of a provider.

Parameters:

  • (String, #read) Locale
  • (String, #read) Namespace
  • (String, #read) provider
  • (String, #read) TransactionIdentifier
  • (String, #read) User

Returns:

  • (uint32) 


30
31
 
# File 'lib/Msft_Providers.rb', line 30

def Load Locale, Namespace, provider, TransactionIdentifier, User
end

- (uint32) Resume

The Resume method resumes execution of providers suspended through the use of the Suspend method.

Returns:

  • (uint32) 


13
14
 
# File 'lib/Msft_Providers.rb', line 13

def Resume 
end

- (uint32) Suspend

The Suspend method suspends execution of providers. All calls passing through a particular instance of the provider will be pass through aninterception layer, this layer will fail the call. Depending on the particular operation, the client may receive the status code WBEM_E_PROVIDER_SUSPENDED

Returns:

  • (uint32) 


7
8
 
# File 'lib/Msft_Providers.rb', line 7

def Suspend 
end

- (uint32) UnLoad

The dynamic UnLoad method unloads the COM server associated with the particular instance of the provider. Further calls intothe provider with the same CLSID will return WBEM_E_PROVIDER_DISABLED. If the COM server implementation is an inproc server hosted in the provider host process it will receive calls to the exported function DllCanUnloadNow, if the provider responds by returning TRUE then COM will unload the executable image. Currently COM is configured to unload the executable approximately 30 seconds after the first successful call to DllCanUnloadNow. If hosted in some other process surrogate the surrogate will unload using some other strategy. The provider can be re-enabled either through the use of the Msft_Provider :Load method, changes to the associated instance of __Win32Provider or via service restart.

Returns:

  • (uint32) 


19
20
 
# File 'lib/Msft_Providers.rb', line 19

def UnLoad 
end