Export (0) Print
Expand All
This topic has not yet been rated - Rate this topic

3.1.4.8.1 RpcAddPrintProcessor (Opnum 14)

RpcAddPrintProcessor installs a print processor on the specified server and adds its name to an internal list of supported print processors.

DWORD RpcAddPrintProcessor(
  [in, string, unique] STRING_HANDLE pName,
  [in, string] wchar_t* pEnvironment,
  [in, string] wchar_t* pPathName,
  [in, string] wchar_t* pPrintProcessorName
);

pName: This parameter MUST adhere to the parameter specification in Print Server Name Parameters (section 3.1.4.1.4).

pEnvironment: This parameter MUST adhere to the parameter specification in Environment Name Parameters (section 3.1.4.1.3).

pPathName: This parameter MUST be a non-NULL pointer to a string that MUST specify the file name of the print processor. For rules governing path names, see section 2.2.4.9.

pPrintProcessorName: This parameter MUST be a non-NULL pointer to a string that MUST specify the name of the print processor. For rules governing print processor names, see section 2.2.4.11.

Return Values: This method MUST return zero (ERROR_SUCCESS) to indicate successful completion or a nonzero Windows error code to indicate failure, as specified in [MS-ERREF].

Upon receiving this message, the server MUST validate parameters as follows:

  • Perform the validation steps that are specified in Print Server Name Parameters.

  • Perform the validation steps that are specified in Environment Name Parameters.

  • Verify that the path identified by the string that is referenced by the pPathName parameter contains the necessary file for installing the print processor.

  • Verify that the print processor to be added does not have the name "winprint", and if that verification fails, return ERROR_PRINT_PROCESSOR_ALREADY_INSTALLED, as specified in [MS-ERREF].

  • Verify that the environment name specified by the pEnvironment parameter is not "Windows ARM", and if that verification fails, return ERROR_NOT_SUPPORTED, as specified in [MS-ERREF].<416>

  • Additional validation MAY<417> be performed.

If parameter validation fails, the server MUST fail the operation immediately and return a nonzero error response to the client. Otherwise, the server MUST process the message and compose a response to the client as follows:

  • Copy the print processor file as appropriate to its destination and overwrite an existing print processor with the same name, if necessary.

  • Create the print processor object.

  • If any clients have registered for notification of server object changes, a notification MUST be broadcast to them.

  • Return the status of the operation.

 
Did you find this helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft. All rights reserved.