The number of sub-condition names returned will vary depending on the sophistication of the server, but is expected to be less than 10 for most servers, making this interface more appropriate than a custom enumerator. It is expected that the available subcondition names for a particular condition on the Server will be fairly 'stable' and that they will generally not change 'online'. However, the Server is in fact allowed to change the available selection at any time. Therefore, a Client should do (or at least allow as an option) a fresh Query every time a selection is to be presented to the end user.
Syntax
| Visual Basic (Declaration) | |
|---|---|
Public Function QuerySubConditionNames( _ ByVal conditionName As String, _ ByRef count As Integer, _ ByRef subConditionNames As String() _ ) As Integer | |
| C# | |
|---|---|
public int QuerySubConditionNames( string conditionName, out int count, out string[] subConditionNames ) | |
Parameters
- conditionName
- A condition name, as returned by the QueryConditionNames method. Only the names of sub-conditions associated with this condition are returned.
- count
- The number of sub-condition names being returned.
- subConditionNames
- Array of strings containing the sub-condition names associated with the specified condition.
Requirements
Target Platforms: Windows XP Professional, Windows Server 2003 family, Windows Vista, Windows 7, Windows Server 2008 family