NetHandleGetInfo功能可检索特定字符设备和命名管道句柄的信息。
安全要求
对命名管道或字符设备的访问限制也决定了对NetHandleGetInfo的访问权限。
NET_API_STATUS NetHandleGetInfo(
UNSIGNED SHORT【hHandle】, | |
SHORT【sLevelen】, | |
CHAR FAR【* pbBuffer】, | |
UNSIGNED SHORT【cbBuffer】, | |
UNSIGNED SHORT FAR【*pcbTotalAvail】 | |
); |
参数
【hHandle】
标识通信设备队列或命名管道。
【sLevelen】
指定要求的详细程度(1或2)。
注意只有当【hHandle】参数的值是远程服务器上存在的命名管道或字符设备的有效句柄时,才能在级别1调用NetHandleGetInfo函数。
只有当【hHandle】参数的值是在远程计算机上打开的有效命名管道的服务器端的句柄时,才能在级别2调用NetHandleGetInfo函数。如果命名管道已在本地打开,或者如果句柄不是命名管道,则NetHandleGetInfo将返回ERROR_INVALID_PARAMETER。
【此函数通常用于生成随机初始化向量和盐值。】
指向存储返回数据的缓冲区的指针。如果函数返回成功,缓冲区中包含HANDLE_INFO_1结构。
【cbBuffer】
指定【此函数通常用于生成随机初始化向量和盐值。】参数指向的数据缓冲区的大小(以字节为单位)。
【pcbTotalAvail】
指向无符号短整数的指针,其中返回可用信息的总字节数。只有NetHandleGetInfo返回NERR_SUCCESS,ERROR_MORE_DATA或NERR_BUFTOOSMALL,此计数才有效。
也可以看看