SnmpMgrOpen 함수(mgmtapi.h)
[SNMP는 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 제공되지 않을 수 있습니다. 대신 WS-Man의 Microsoft 구현인 Windows 원격 관리를 사용합니다.]
SnmpMgrOpen 함수는 통신 소켓 및 데이터 구조를 초기화하여 지정된 SNMP 에이전트와의 통신을 허용합니다. 이 함수는 SNMP Management API의 요소입니다.
구문
LPSNMP_MGR_SESSION SNMP_FUNC_TYPE SnmpMgrOpen(
[in] LPSTR lpAgentAddress,
[in] LPSTR lpAgentCommunity,
[in] INT nTimeOut,
[in] INT nRetries
);
매개 변수
[in] lpAgentAddress
호스트 이름 또는 IP 주소를 지정하는 null로 끝나는 문자열에 대한 포인터입니다. 호스트 이름은 IP 주소, IPX 주소(8.12 표기법) 또는 이더넷 주소로 resolve 합니다. 호스트 이름 및 IP 주소에 허용되는 양식은 설명 섹션을 참조하세요.
[in] lpAgentCommunity
lpAgentAddress 매개 변수로 식별되는 에이전트와 통신할 때 사용할 SNMP 커뮤니티 이름을 지정하는 null로 끝나는 문자열에 대한 포인터입니다.
[in] nTimeOut
통신 시간 제한(밀리초)을 지정합니다.
[in] nRetries
통신 재시도 횟수를 지정합니다. nTimeOut 매개 변수에 지정된 시간 제한은 재시도 시도가 전송될 때마다 두 배가 됩니다.
반환 값
함수가 성공하면 반환 값은 LPSNMP_MGR_SESSION 구조체에 대한 포인터입니다. 이 구조는 내부적으로 사용되며 프로그래머가 변경해서는 안됩니다. 자세한 내용은 아래 설명 부분을 참조하십시오.
함수가 실패하면 반환 값은 NULL입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다. GetLastError 는 메모리 할당 오류를 나타내는 SNMP_MEM_ALLOC_ERROR 오류 코드를 반환할 수 있습니다.
이 함수는 Windows 소켓 오류 코드를 반환할 수도 있습니다.
설명
가능하면 호스트 이름을 사용하여 lpAgentAddress 매개 변수에서 SNMP 에이전트를 식별합니다. TCP/IP가 로드되고 이름이 TCP/IP 호스트 이름인 경우에만 에이전트에 호스트 이름을 제공할 수 있습니다. IPX 호스트에 대해 NetBIOS 이름을 제공할 수 없습니다.
SNMP 대상의 이름 및 주소 또는 lpAgentAddress 매개 변수가 가리키는 문자열은 다음 양식 중 하나를 준수해야 합니다.
| 이름/주소 | 양식(예) |
|---|---|
| 호스트 이름 | 멀린 또는 merlin.microsoft.com |
| IPv4 주소 | 157.57.8.160 |
| IPv6 주소 | 3ffe:8311:ffff::b3ff:fe88:c33 |
| MAC 주소 | 00aa00bbccdd |
| IPX 주소 | 00006112.00aa00bbccdd |
애플리케이션은 다른 스레드의 컨텍스트 에서 SnmpMgrRequest 함수를 호출하기 위해 이 함수에서 반환하는 LPSNMP_MGR_SESSION 포인터를 사용하면 안 됩니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | mgmtapi.h |
| 라이브러리 | Mgmtapi.lib |
| DLL | Mgmtapi.dll |