NetHandleSetInfo

The NetHandleSetInfo function sets handle-specific information for character-device and named-pipe handles.

Security Requirements

Access restrictions to the character device or named pipe determines access privilege.

NET_API_STATUS NetHandleSetInfo(
  UNSIGNED SHORT hHandle,        
  SHORT sLevel,                  
  CHAR FAR *pbBuffer,            
  UNSIGNED SHORT cbBuffer,       
  UNSIGNED SHORT FAR *sParmNum   
);
 

Parameters

hHandle

Identifies a communication-device queue or a named pipe.

sLevel

Specifies the level of detail provided; must be 1.

pbBuffer

Pointer to the data to be set.

cbBuffer

Specifies the size, in bytes, of the buffer pointed to by the pbBuffer parameter.

sParmNum

Specifies whether to reset all handle information or to change only a part of it. If the value of sParmNum is PARMNUM_ALL, the pbBuffer parameter must point to the handle_info_1 structure, and the previous handle information is replaced by this new information. If sParmNum is any other defined value, only one element of the handle information is changed, and the pbBuffer parameter must point to a valid value for that element.

QuickInfo

  Windows NT: Requires version 3.1 or later.
  Windows: Unsupported.
  Windows CE: Unsupported.
  Header: Declared in lmchdev.h.
  Import Library: Use netapi32.lib.

See Also

Networking (Net) Overview, Net Functions, HANDLE_INFO_1, NetHandleSetInfo