3.1.4.3.3 RpcAsyncAddPort (Opnum 49)

RpcAsyncAddPort adds a specified port name to the list of supported ports on a specified print server.

The counterpart of this method in the Print System Remote Protocol is RpcAddPortEx. All parameters not defined below are specified in [MS-RPRN] section 3.1.4.6.3.

 DWORD RpcAsyncAddPort(
   [in] handle_t hRemoteBinding,
   [in, string, unique] wchar_t* pName,
   [in] PORT_CONTAINER* pPortContainer,
   [in] PORT_VAR_CONTAINER* pPortVarContainer,
   [in, string] wchar_t* pMonitorName
 );

hRemoteBinding: An RPC explicit binding handle. RPC binding handles are specified in [C706] section 2.3.

Return Values: This method returns zero to indicate successful completion or a nonzero Win32 error code ([MS-ERREF] section 2.2) to indicate failure. 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.6.3.