NWGetDefaultNameContext(3nw)


NWGetDefaultNameContext -- allows the user to get the default name context

Synopsis

   #include <nwnet.h 
   see also 
   #include <nwndscon.h> 
   

NWCCODE N_API NWGetDefaultNameContext (nuint16 bufferSize, nuint8 N_FAR * context);

Description

The parameters are as follows:

bufferSize
(IN) Specifies the maximum size of buffer.

context
(OUT) Points to a buffer retrieving the 256-byte default name context. A NULL-terminated string containing the name context is returned.

Return values

0x0000
SUCCESSFUL

0x8833
INVALID_BUFFER_LENGTH

Notices

The name may have been set originally in NET.CFG, or it could be set by calling NWSetDefaultNameContext. If the name context is empty, a NULL string is returned.

To call NWGetDefaultNameContext in DOS or Windows, VLMs must be running. NETX does not support NWGetDefaultNameContext and will return an error if VLMs are not running.

Services

Connection (Directory Support)

NCP calls

None

References

NWSetDefaultNameContext(3nw)
30 January 1998
© 1998 The Santa Cruz Operation, Inc. All rights reserved.