|
Overview |
|
|
|
Group |
|
|
|
Quick Info
Windows NT
| Yes
| Win95
| No
| Win32s
| No
| Import Library
| netapi32.lib
| Header File
| lmchdev.h
| Unicode
| WinNT
| Platform Notes
| All LanMan APIs are UNICODE only
|
|
|
NetHandleGetInfo
The NetHandleGetInfo function retrieves handle-specific information for character-device and
named-pipe handles.
Security Requirements
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
|
| );
|
|
Parameters
hHandle
Identifies a communication-device queue or a named pipe.
sLevel
Specifies the level of detail (1 or 2) requested.
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.
pbBuffer
Pointer to the buffer in which to store the returned data. If the function
returns successfully, the buffer contains a HANDLE_INFO_1 structure.
cbBuffer
Specifies the size, in bytes, of the data buffer pointed to by the pbBuffer parameter.
pcbTotalAvail
Pointer to an unsigned short integer in which the total number of bytes of
information available is returned. This count is valid only if NetHandleGetInfo returns NERR_SUCCESS, ERROR_MORE_DATA, or NERR_BUFTOOSMALL.
See Also
HANDLE_INFO_1, NetHandleSetInfo
Related Links
Software for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET
TMS Scripter Studio Pro components for Delphi/C++Builder
More Online Helps
Win32 Multimedia Programmer's Reference (mmedia.hlp)
OLE Programmer's Reference (ole.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Microsoft Windows Telephony API (TAPI) Programmer's Reference (tapi.hlp)
Unix Manual Pages
|
