Share via

3.1.4.1.8.3 DRIVER_CONTAINER Parameters

  • Article

pDriverContainer: This parameter is a pointer to a DRIVER_CONTAINER (section 2.2.1.2.3) structure that specifies printer driver information. The value of the Level member of the DRIVER_CONTAINER structure MUST be 0x00000002, 0x00000003, 0x00000004, 0x00000006, or 0x00000008.

The individual method sections include the following parameter validation steps by reference:

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

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

  • Verify that, within the DRIVER_INFO (section 2.2.1.5) structure that is contained in DRIVER_CONTAINER, the pEnvironment member specifies an environment name that is supported on the server (section 2.2.4.4). If that verification fails, return ERROR_INVALID_ENVIRONMENT.

  • Verify that all members of DRIVER_CONTAINER comply with the constraints defined in section 2.2.1.2.3.

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