3.1.4.1.8.9 MONITOR_CONTAINER Parameters

  • Article

pMonitorContainer: This parameter is a pointer to a MONITOR_CONTAINER (section 2.2.1.2.6) structure that specifies monitor information. The individual method sections include the following parameter validation steps by reference:

  • If the pMonitorContainer parameter is declared with the "unique" IDL attribute, and its value is NULL, skip the validation steps and assume validation success.

  • Verify that pMonitorContainer points to a MONITOR_CONTAINER that specifies an appropriate level as defined in the referring method definition. If that verification fails, return ERROR_INVALID_LEVEL.

  • If the value of the Level member specifies a MONITOR_INFO structure that contains a pEnvironment member, verify that the string that is referenced by pEnvironment identifies an environment name that is supported on this server; and if that verification fails, return ERROR_INVALID_ENVIRONMENT.

  • If the value of the Level member specifies a MONITOR_INFO structure that contains a pEnvironment member, the environment name referenced by pEnvironment is "Windows ARM", and this server doesn’t support that environment name (section 2.2.4.4), return ERROR_NOT_SUPPORTED. Print servers can optionally be configured to not perform this validation step.<262>

  • Verify that all members of the MONITOR_CONTAINER structure comply with the constraints defined in 2.2.1.8.

Unless noted otherwise, if any of the preceding validation steps fail, return ERROR_INVALID_PARAMETER.