3.1.4.13.1 RpcLogJobInfoForBranchOffice (Opnum 116)
RpcLogJobInfoForBranchOffice processes one or more Branch Office Print Remote Log Entries (section 3.1.1).<401>
-
DWORD RpcLogJobInfoForBranchOffice( [in] PRINTER_HANDLE hPrinter, [in, ref] RPC_BranchOfficeJobDataContainer* pBranchOfficeJobDataContainer );
hPrinter: A PRINTER_HANDLE (section 2.2.1.1.4) to a printer object that was opened by RpcAddPrinter (section 3.1.4.2.3), RpcAddPrinterEx (section 3.1.4.2.15), RpcOpenPrinter (section 3.1.4.2.2), or RpcOpenPrinterEx (section 3.1.4.2.14).
pBranchOfficeJobDataContainer: A pointer to an RPC_BranchOfficeJobDataContainer (section 2.2.1.2.17) structure that contains one or more RPC_BranchOfficeJobData (section 2.2.1.15.2) structures, each of which holds a single Branch Office Print Remote Log Entry.
Return Values: This method MUST return zero (ERROR_SUCCESS) to indicate successful completion or a nonzero Windows error code to indicate failure [MS-ERREF].
On receiving this message, the server MUST validate the following:
Perform the validation steps that are specified in PRINTER_HANDLE Parameters (section 3.1.4.1.11). This method SHOULD assume that the handle to the printer object can be used without further access checks.
Verify that the value of the pBranchOfficeJobDataContainer parameter is a pointer, and if that verification fails, return ERROR_INVALID_PARAMETER.
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:
Create event channel entries that correspond to the data in the array of RPC_BranchOfficeJobData structures in the RPC_BranchOfficeJobDataContainer structure specified by the pBranchOfficeJobDataContainer parameter. The number of structures is specified by the cJobDataEntries member of the container structure.
Return the status of the operation.