findnlmhandle

Returns the handle of the NLM that corresponds to the specified name.

Library:LibC
Service:Library

Syntax

  #include <library.h> 
   
  void *findnlmhandle (
     const char   *name, 
     addrsp_t      space);

Parameters

name

(IN) Points to the name of the NLM.

space

(IN) Points to the address of the NLM.

  • If NULL, the NLM is sought for in any address space

  • If non-NULL, the NLM name is sought in the specified address space.

Return Values

Returns an NLM handle (a non-null value)

  • If the NLM is found in the specified address space.

  • If the space parameter was set to NULL and the NLM was found.

Returns NULL

  • If the name cannot be found in the specified address space.

  • If the space parameter was set to NULL and the NLM was not found in any address space.

Remarks

The NLM handle is a way to identify an NLM process and uniquely identifies any NLM running on NetWare, without regard to address space. This value is not related in any way to the NKS identifier for a virtual machine (NXVmId_t).

See Also