The NetHandleGetInfo function retrieves handle-specific information for character-device and named-pipe handles.
Access restrictions to the named pipe or character device also determine access privileges to NetHandleGetInfo.
NET_API_STATUS NetHandleGetInfo(
UNSIGNED SHORT hHandle,
SHORT sLevel,
CHAR FAR *pbBuffer,
UNSIGNED SHORT cbBuffer,
UNSIGNED SHORT FAR *pcbTotalAvail
);
Note The NetHandleGetInfo function can be called at level 1 only if the value of the hHandle parameter is a valid handle to a named pipe or character device that exists on a remote server.
The NetHandleGetInfo function can be called at level 2 only if the value of the hHandle parameter is a handle to the server side of a valid named pipe opened on a remote computer. If the named pipe has been opened locally or if the handle is not for a named pipe, NetHandleGetInfo returns ERROR_INVALID_PARAMETER.
Windows NT: Requires version 3.1 or later.
Windows: Unsupported.
Windows CE: Unsupported.
Header: Declared in lmchdev.h.
Import Library: Use netapi32.lib.
Networking (Net) Overview, Net Functions, HANDLE_INFO_1, NetHandleSetInfo