SnmpListen 함수(winsnmp.h)

아티클
03/15/2023

[SNMP는 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 제공되지 않을 수 있습니다. 대신 WS-Man의 Microsoft 구현인 Windows 원격 관리를 사용합니다.]

WinSNMP SnmpListen 함수는 WinSNMP 애플리케이션을 SNMP 에이전트로 등록합니다. 에이전트 애플리케이션은 이 함수를 호출하여 엔터티가 SNMP 에이전트의 역할로 작동할 것임을 Microsoft WinSNMP 구현에 알릴 수 있습니다. 또한 애플리케이션은 이 함수를 호출하여 엔터티가 이 역할에서 더 이상 작동하지 않을 때 구현에 알릴 수 있습니다. SnmpListen 함수는 WinSNMP API 버전 2.0의 요소입니다.

구문

SNMPAPI_STATUS SNMPAPI_CALL SnmpListen(
  [in] HSNMP_ENTITY   hEntity,
  [in] SNMPAPI_STATUS lStatus
);

매개 변수

[in] hEntity

Microsoft WinSNMP 구현이 들어오는 SNMP 요청 메시지(PDU)를 수신할 때 알리기 위해 WinSNMP 엔터티에 대한 핸들입니다. 이 매개 변수는 에이전트 애플리케이션을 식별합니다. 자세한 내용은 다음 설명 및 반환 값 섹션을 참조하세요.

SnmpCreateSession 함수를 호출할 때 구현에서 창 알림 메시지 또는 SNMPAPI_CALLBACK 함수를 사용하여 SNMP 메시지 또는 비동기 이벤트를 사용할 수 있을 때 애플리케이션에 알릴지 여부를 지정할 수 있습니다.

[in] lStatus

hEntity 매개 변수로 식별된 WinSNMP 엔터티가 SNMP 에이전트 역할에서 작동하는지 또는 이 역할에서 더 이상 작동하지 않는지 여부를 나타내는 부호 없는 긴 정수 변수를 지정합니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

값	의미
SNMPAPI_ON	지정된 WinSNMP 엔터티가 에이전트 역할에서 작동합니다.
SNMPAPI_OFF	지정된 WinSNMP 엔터티가 에이전트 역할에서 작동하지 않습니다.

SNMPAPI_OFF 값을 전달하면 엔터티에 할당된 리소스와 할당된 포트가 모두 해제됩니다. 자세한 내용은 아래 설명 부분을 참조하십시오.

반환 값

함수가 성공하면 반환 값이 SNMPAPI_SUCCESS.

함수가 실패하면 반환 값이 SNMPAPI_FAILURE. 확장된 오류 정보를 얻으려면 SnmpGetLastError를 호출합니다. SnmpGetLastError 함수는 다음 오류 중 하나를 반환할 수 있습니다.

반환 코드	설명
SNMPAPI_NOT_INITIALIZED	SnmpStartup 함수가 성공적으로 완료되지 않았습니다.
SNMPAPI_ALLOC_ERROR	메모리 할당 중에 오류가 발생했습니다.
SNMPAPI_ENTITY_INVALID	hEntity 매개 변수가 잘못되었습니다. 이 매개 변수는 SnmpStrToEntity 함수에 대한 이전 호출에서 반환된 핸들이어야 합니다.
SNMPAPI_MODE_INVALID	lStatus 매개 변수가 잘못되었습니다.
SNMPAPI_NOOP	hEntity 매개 변수로 지정된 엔터티가 SNMP 에이전트의 역할에서 이미 작동하고 있습니다.
SNMPAPI_TL_RESOURCE_ERROR	네트워크 전송 계층 오류가 있습니다. hEntity 매개 변수로 지정된 엔터티에 대해 소켓을 만들 수 없습니다.
SNMPAPI_TL_OTHER	hEntity 매개 변수로 지정된 엔터티에 대한 소켓을 바인딩하는 동안 네트워크 전송 계층에서 오류가 발생했습니다.
SNMPAPI_OTHER_ERROR	알 수 없거나 정의되지 않은 오류가 발생했습니다.

설명

엔터티를 지정할 때 엔터티의 주소 패밀리, 인터페이스 주소 및 포트를 명시적으로 지정합니다. WinSNMP는 SnmpStrToEntity 함수 호출의 결과로 각 WinSNMP 엔터티에 이러한 특성을 할당하기 때문입니다. 구현은 에이전트 애플리케이션에 알림을 보낼 때 hEntity 매개 변수로 지정된 엔터티에 현재 할당된 주소 및 포트 설정을 사용합니다. 자세한 내용은 SnmpSetPort를 참조하세요.

WinSNMP 세션에 대해 SnmpClose 함수를 호출하고 WinSNMP 애플리케이션에 대한 SnmpCleanup 함수를 호출하는 경우 WinSNMP 에이전트 애플리케이션과 연결된 모든 포트를 해제해야 합니다.

SNMP 관리 애플리케이션 및 에이전트 애플리케이션에 대한 자세한 내용은 SNMP 에이전트 애플리케이션 등록 및 SNMP 정보를 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	winsnmp.h
라이브러리	Wsnmp32.lib
DLL	Wsnmp32.dll