Prev Next

NetHandleSetInfo info  Overview  Group

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.

See Also

HANDLE_INFO_1, NetHandleSetInfo