NWSMSetDynamicCmdStrValue

Changes the current values of a set command (that takes in string values) on a specified server

NetWare Server:3.x, 4.x, 5.x, 6.x
Platform:NLM, Windows NT, Windows 95, Windows 98
Library:Cross-Platform NetWare Calls (CAL*.*)
Service:Server Management

Syntax

  #include <nwsm.h> 
  or 
  #include <nwcalls.h> 
   
  N_EXTERN_LIBRARY NWCCODE NWSMSetDynamicCmdStrValue (
     NWCONN_HANDLE        connHandle,  
     const nstr8 N_FAR   *setCommandName,  
     const nstr8 N_FAR   *cmdValue);
  

Delphi Syntax

  uses calwin32 
   
  Function NWSMSetDynamicCmdStrValue 
    (connHandle : NWCONN_HANDLE; 
     setCommandName : pnstr8; 
     cmdValue : pnstr8 
  ) : NWCCODE; 
  

Parameters

connHandle
(IN) Specifies the server connection handle which is being managed.
setCommandName
(IN) Points to the parameter command name. It must be NULL terminated.
cmdValue
(IN) Points to the new value for the set command parameter. It must be NULL terminated.

Return Values

These are common return values; see Return Values (NDK: Connection, Message, and NCP Extensions) for more information.

0x0000

SUCCESS

0x008C

Invalid type flag value

0x00BF

No setCommandName string

0x0206

Unable to set the command

0x8801

INVALID_CONNECTION

0x890A

NLM_INVALID_CONNECTION

0x89FB

ERR_NCP_NOT_SUPPORTED

Remarks

You must be logged into connHandle, be permanently authenticated, and have console operator rights at the minimum to call NWSMSetDynamicCmdStrValue.

The server console SET command is documented in the NetWare server utilities documentation. The SET values OFF/ON are treated as the integers 0 (zero) and 1 respectively; they are not treated as strings.

NCP Calls

See Also

NWGetServerSetCommandsInfo, NWGetServerSetCategories, NWSMSetDynamicCmdIntValue