KnowledgeBase Archive

An Archive of Early Microsoft KnowledgeBase Articles

View on GitHub

Q172479: DMOD limited to 4 Non-RPC Callbacks for API Libraries

Article: Q172479
Product(s): Microsoft SNA Server
Version(s): WINDOWS:3.0,3.0 SP1
Operating System(s): 
Keyword(s): kbnetwork
Last Modified: 02-APR-2000

-------------------------------------------------------------------------------
The information in this article applies to:

- Microsoft SNA Server, versions 3.0, 3.0 SP1 
-------------------------------------------------------------------------------


SYMPTOMS
========

When an application calls the Microsoft SNA Server APIs and these functions need
to register a callback, the application will fail when it tries to register more
than four callbacks.

CAUSE
=====

The Microsoft SNA Server DMOD component is limited to four non-RPC callback
routines for API libraries per process.

STATUS
======

Microsoft has confirmed this to be a problem in SNA Server versions 3.0 and 3.0
Service Pack 1 (SP1). This problem was corrected in the latest SNA Server
version 3.0 U.S. Service Pack. For information on obtaining this Service Pack,
query on the following word in the Microsoft Knowledge Base (without the
spaces):

  S E R V P A C K


MORE INFORMATION
================

When an application needs to perform its own routing of received messages, the
DMOD adds the specified procedure to a list of procedures called whenever a
message is received.

The following example will illustrate a failing situation:

When an application issues the following function calls,

  sli_open();
  acssvc_convert();
  appc_display();

the sequence of registring callback routines is as follows:

  RPC registers a callback, rout_cnt (the count of callbacks
     registered) = 1
  RUI registers a callback, rout_cnt = 2
  CSV registers a callback, rout_cnt = 3
  APPC registers a callback (for conversation verbs), rout_cnt = 4

  APPC tries to register another callback (for DISPLAY & CNOS management
     verbs)

The DMOD fails this request and the DISPLAY verb fails, because it already has
four callbacks registered.


Additional query words: route

======================================================================
Keywords          : kbnetwork 
Technology        : kbAudDeveloper kbSNAServSearch kbSNAServ300 kbSNAServ300SP1
Version           : WINDOWS:3.0,3.0 SP1
Issue type        : kbbug
Solution Type     : kbfix

=============================================================================

THE INFORMATION PROVIDED IN THE MICROSOFT KNOWLEDGE BASE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. MICROSOFT DISCLAIMS ALL WARRANTIES, EITHER EXPRESS OR IMPLIED, INCLUDING THE WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE. IN NO EVENT SHALL MICROSOFT CORPORATION OR ITS SUPPLIERS BE LIABLE FOR ANY DAMAGES WHATSOEVER INCLUDING DIRECT, INDIRECT, INCIDENTAL, CONSEQUENTIAL, LOSS OF BUSINESS PROFITS OR SPECIAL DAMAGES, EVEN IF MICROSOFT CORPORATION OR ITS SUPPLIERS HAVE BEEN ADVISED OF THE POSSIBILITY OF SUCH DAMAGES. SOME STATES DO NOT ALLOW THE EXCLUSION OR LIMITATION OF LIABILITY FOR CONSEQUENTIAL OR INCIDENTAL DAMAGES SO THE FOREGOING LIMITATION MAY NOT APPLY.