На главную

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 | Скачать Вниз

SnmpMgrOpen



The SnmpMgrOpen function initializes communications sockets and data structures, allowing communications with the specified agent.

LPSNMP_MGR_SESSION SnmpMgrOpen(

LPSTR lpAgentAddress, // name and address of target SNMP agent
LPSTR lpAgentCommunity, // community for target SNMP agent
INT nTimeOut, // communication time-out in milliseconds
INT nRetries // communication time-out or retry count
);


Parameters

lpAgentAddress

[in] Points to a null-terminated string specifying either a dotted-decimal IP address or a host name that can be resolved to an IP address, an IPX address (in 8.12 notation), or an ethernet address.

lpAgentCommunity

[in] Points to a null-terminated string specifying the SNMP community name used when communicating with the agent specified in the lpAgentAddress parameter.

nTimeOut

[in] Specifies the communications time-out in milliseconds.

nRetries

[in] Specifies the communications retry count. The time-out specified in the nTimeOut parameter is doubled each time a retry attempt is transmitted.



Return Values

If the function succeeds, the return value is a pointer to an LPSNMP_MGR_SESSION structure. This structure is used internally and the programmer should not alter it.
If the function fails, the return value is NULL. To get extended error information, call GetLastError. GetLastError may return the SNMP_MEM_ALLOC_ERROR error code, which indicates a memory allocation error.
This function may also return Windows Sockets error codes.
The name and address of the SNMP target, or the string pointed to by the lpAgentAddress parameter, should conform to one of the following forms:

Name/Address Form (example)
IP Address 157.57.8.160
IP Hostname merlin.microsoft.com
Ethernet Address 00aa00bbccdd
IPX Address 00006112.00aa00bbccdd


Remarks

Names can be provided for agents only if TCP/IP is loaded and the names are TCP/IP host names. NetBIOS names cannot be supplied for IPX hosts.

See Also

SnmpMgrClose, SnmpMgrRequest


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

SnmpMgrOpen



Функция SnmpMgrOpen инициализирует розетки связи и структур данных, допускающие связь с определенным агентом.

LPSNMP_MGR_SESSION SnmpMgrOpen(

LPSTR lpAgentAddress, // ИМЯ и адрес целевого агента SNMP lpAgentCommunity LPSTR, // общества для целевого агента SNMP INT nTimeOut, // задержки связи в течение задержки связи миллисекунд INT nRetries // или счет повторной попытки
);


Параметры

lpAgentAddress

[in] Указывает на недействительный расторгнутую строку, определяющую или точечный-десятичный адрес IP или главное имя, которые могут быть решены в адрес IP, адрес IPX (в 8.12 нотациях), или адрес ethernet.

lpAgentCommunity

[in] Указывает на недействительный расторгнутую строку, определяющую, что общественное имя SNMP использовало передаваясь с агентом определенным в параметре lpAgentAddress.

nTimeOut

[in] Определяет задержку связи в течение миллисекунд.

nRetries

[in] Определяет счет повторной попытки связи. Задержка определенная в параметре nTimeOut удвоена всякий раз, когда попытка повторной попытки передана.



Обратные Величины

Если функция добивается успеха, обратная величина является указателем в структуру LPSNMP_MGR_SESSION. Эта структура используется непосредственно и программист не должен изменять это.
Если функция терпит неудачу, обратная величина НЕДЕЙСТВИТЕЛЬНА. Для того, чтобы расширять информацию ошибки, назовите GetLastError. GetLastError МОЖЕТ возвращать код ошибки SNMP_MEM_ALLOC_ERROR, который указывает ошибку распределения памяти.
Эта функция может также возвращать ошибку Розеток Windows кодировать.
Имя и адрес SNMP нацеливают, или строка указывалась, чтобы параметром lpAgentAddress, должно соответствовать одному из следующего форм:

ФОРМА Name/Address (пример) Адрес IP 157.57.8.160 IP Hostname Адреса merlin.microsoft.com Ethernet Адреса 00aa00bbccdd IPX 00006112.00aa00bbccdd


Замечания

Имена могут быть предусмотрены для агентов только если TCP/IP загружен и имена являются TCP/IP главных имен. NetBIOS НАЗЫВАЕТ не мочь быть поставлено для хозяев IPX.

Смотри Также

SnmpMgrClose, SnmpMgrRequest


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