3.1.4.1.17 FAX_EndServerNotification (Opnum 75)

  • Article

The FAX_EndServerNotification (Opnum 75) method is called by the client to stop the notifications from the server, which were initiated by a call to FAX_StartServerNotification (section 3.1.4.1.100), FAX_StartServerNotificationEx (section 3.1.4.1.101), or FAX_StartServerNotificationEx2 (section 3.1.4.1.102).

On success, the server MUST stop notifying the client of events. 

 error_status_t FAX_EndServerNotification(
   [in, out, ref] PRPC_FAX_EVENT_EX_HANDLE lpHandle
 );

lpHandle: A pointer to a previously registered subscription context handle. The lpHandle parameter MUST match the one supplied by the server when the FAX_StartServerNotification family of calls is in use.

Return Values: This method MUST return 0x00000000 (ERROR_SUCCESS) for success; otherwise, it MUST return one of the following error codes, one of the fax-specific errors that are defined in section 2.2.52, or one of the other standard errors defined in [MS-ERREF] section 2.2.

Return value/code

Description

ERROR_INVALID_DATA

0x0000000D

This error SHOULD be returned if the lpHandle parameter is not a valid handle obtained using the FAX_StartServerNotification method, the FAX_StartServerNotificationEx method, or the FAX_StartServerNotificationEx2 method.<81>

ERROR_INVALID_PARAMETER

0x00000057

lpHandle is specified as NULL.<82>

To stop notifications, the client SHOULD call FAX_EndServerNotification; the server SHOULD call FAX_CloseConnection section 3.2.4.4) to close the connection.

Exceptions Thrown: No exceptions are thrown except those that are thrown by the underlying RPC protocol, [MS-RPCE].