If the HRESULT is S_OK, then the client can ignore errors (all results in it are guaranteed to be S_OK). If the HRESULT is a FAILED code then the server should return null (Nothing) for each of the OUT parameters.
Syntax
| Visual Basic (Declaration) | |
|---|---|
Public Function GetEnableStateByArea( _ ByVal areas() As String, _ ByRef enabled As Boolean(), _ ByRef effectivelyEnabled As Boolean(), _ ByRef errors As Integer() _ ) As Integer | |
| C# | |
|---|---|
public int GetEnableStateByArea( string[] areas, out bool[] enabled, out bool[] effectivelyEnabled, out int[] errors ) | |
Parameters
- areas
- Array of area names, as returned by EventAreaBrowser.GetQualifiedAreaName
- enabled
- Array of BOOL indicating the current enable state of the corresponding area. TRUE if the area is enabled, FALSE if it is disabled. Note this value reflects the state as a result of the last call to EnableConditionByArea2 or DisableConditionByArea2. In other words, it does not reflect the enable state of the containing areas in its hierarchy.
- effectivelyEnabled
- Array of BOOL indicating the effective enable state of the corresponding area. TRUE if the area is enabled and all areas within the hierarchy of its containing areas are enabled. FALSE if the area is disabled or any area within the hierarchy of its containing areas is disabled.
- errors
- Array of HRESULTS indicating the success of retrieving the enable state of the area. The errors correspond to the areas passed into the method.
Requirements
Target Platforms: Windows XP Professional, Windows Server 2003 family, Windows Vista, Windows 7, Windows Server 2008 family