На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

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


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

NetHandleGetInfo



Функция NetHandleGetInfo извлекает оперировать-специфической информации для символьного-устройства и поименованной трубы ручек.

Требования Безопасности

Ограничения Доступа в поименованную трубу или символьное устройство также определяет привилегии доступа на NetHandleGetInfo.

NET_API_STATUS NetHandleGetInfo(

БЕЗ ЗНАКА ПЕРЕМЫЧКА hHandle, SHORT sLevel, CHAR ЗНАЧИТЕЛЬНО *pbBuffer, БЕЗ ЗНАКА ПЕРЕМЫЧКА cbBuffer, БЕЗ ЗНАКА ПЕРЕМЫЧКА ЗНАЧИТЕЛЬНО *pcbTotalAvail
);


Параметры

hHandle

Идентифицирует связь-устройство очереди или поименованная труба.

sLevel

Определяет уровень детали (1 или 2) запрошенное.



Отметьте, что функция NetHandleGetInfo может быть названа на уровне 1 только если величина параметра hHandle является правильной ручкой в поименованную трубу или символьное устройство, которые существуют в дистанционном сервере.
Функция NetHandleGetInfo может быть названа на уровне 2 только если величина параметра hHandle является ручкой на сторону сервера правильной поименованной трубы открытой в дистанционном компьютере. Если поименованная труба открывается локально или если ручка - не для поименованной трубы, возврат NetHandleGetInfo ERROR_INVALID_PARAMETER.



pbBuffer

Указатель в буфер, чтобы загружать возвращанные данные. Если функция возвращается успешно, буфер содержит структуру HANDLE_INFO_1.

cbBuffer

Определяет размер, в байтах, буфера данных указанного, чтобы параметром pbBuffer.

pcbTotalAvail

Указатель в без знака короткое целое в котором общее число байтов информационное доступное возвращано. Этот счет - в силе только если возврат NetHandleGetInfo NERR_SUCCESS, ERROR_MORE_DATA, или NERR_BUFTOOSMALL.



Смотри Также

HANDLE_INFO_1, NetHandleSetInfo


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz