TestConfiguration method of the MSFT_DSCLocalConfigurationManager class

Sends the configuration document to the managed node and verifies the current configuration against the document.

Syntax

uint32 TestConfiguration(
  [in]  uint8                          configurationData[],
  [out] boolean                        InDesiredState,
  [out] MSFT_ResourceInDesiredState    ResourcesInDesiredState[],
  [out] MSFT_ResourceNotInDesiredState ResourcesNotInDesiredState[]
);

Parameters

configurationData [in]
Environment data for the confuguration.

InDesiredState [out]
On return, specifies whether the managed node is in the state specified by the configuration document.

ResourcesInDesiredState [out]
On return, contains an embedded instance of the MSFT_ResourceInDesiredState class that specifies resources that are in the desired state.

ResourcesNotInDesiredState [out]
On return, contains an embedded instance of the MSFT_ResourceNotInDesiredState class that specifies resources that are not in the desired state.

Return value


Returns zero on success; otherwise returns an error code.

Remarks

This is a static method.

Requirements


MOF: DscCore.mof

Namespace: Root\Microsoft\Windows\DesiredStateConfiguration

See also

MSFT_DSCLocalConfigurationManager