3.1.4.6.3 RpcAsyncGetForm (Opnum 23)
RpcAsyncGetForm retrieves information about a specified printer form.
The counterpart of this method in the Print System Remote Protocol is RpcGetForm. All parameters not defined below are specified in [MS-RPRN] section 3.1.4.5.3.
-
DWORD RpcAsyncGetForm( [in] PRINTER_HANDLE hPrinter, [in, string] wchar_t* pFormName, [in] DWORD Level, [in, out, unique, size_is(cbBuf)] unsigned char* pForm, [in] DWORD cbBuf, [out] DWORD* pcbNeeded );
hPrinter: A handle to a printer object or server object that has been opened by using either RpcAsyncOpenPrinter (section 3.1.4.1.1) or RpcAsyncAddPrinter (section 3.1.4.1.2).
Return Values: This method returns zero to indicate successful completion or a nonzero Win32 error code ([MS-ERREF] section 2.2) to indicate failure. Aside from the specific nonzero return values documented in section 3.1.4, the client MUST treat any nonzero return value as a fatal error.
Exceptions Thrown: This method MUST NOT throw any exceptions other than those that are thrown by the underlying RPC protocol [MS-RPCE].
This method MUST adhere to the parameter validation, processing, and response requirements that are specified in [MS-RPRN] section 3.1.4.5.3.