NWGetObjectNamesBeginA

Sets up an environment so that NWGetObjectNamesNextA can retrieve the names of trees or servers

Local Servers:blocking
Remote Servers:blocking
NetWare Server:3.11, 3.12, 3.2, 4.x, 5.x, 6.x
Platform:NLM, Windows NT*, Windows* 95, Windows 98
Service:Name Retrieval

Syntax

   #include <nwbindry.h)
   
   NWCCODE  NWGetObjectNamesBeginA (
      nuint32    luObjectType,
      pnuint32   pluHandle);
   

Pascal Syntax

   uses calwin32 
    
   Function NWGetObjectNamesBeginA(
      luObjectType : nuint32;
      Var pluHandle : nuint32 
   ) : NWCCODE; stdcall;
   

Parameters

luObjectType
(IN) Specifies which type of object names are to be retrieved.
pluHandle
(OUT) Points to a value used by NWGetObjectNamesNextA and NWGetObjectNamesEndA, which should never be changed directly.

Return Values

Returns zero on success. The most common return values on failure include the following:

0x8836

NWE_PARAM_INVALID

0x88FF

NWE_REQUESTER_FAILURE

0x881A

NWE_OUT_OF_HEAP_SPACE

Remarks

NWGetObjectNamesBeginA internally calls WinSock2 name space functions to retrieve tree or server names from SAP and SLP name spaces. It also allocates a buffer to store retrieved names as a sorted and ordered list.

The luObjectType parameter can have the following values:

0x0400

OT_FILE_SERVER

0x7802

OT_TREE_NAME

See Also

NWGetObjectNamesNextA, NWGetObjectNamesEndA