다음을 통해 공유

SnmpStartup 함수(winsnmp.h)

  • 아티클

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

SnmpStartup 함수는 Microsoft WinSNMP 구현에 WinSNMP 애플리케이션에 구현의 서비스가 필요하다는 것을 알 수 있습니다. WinSNMP SnmpStartup 함수를 사용하면 구현에서 Windows SNMP API(애플리케이션 프로그래밍 인터페이스) 버전, 구현에서 지원하는 SNMP 통신 수준 및 구현의 기본 변환 및 재전송 모드를 초기화하고 애플리케이션으로 돌아갈 수 있습니다.

참고 WinSNMP 애플리케이션은 다른 WinSNMP 함수를 호출하기 전에 SnmpStartup 함수를 성공적으로 호출해야 합니다.
 

구문

SNMPAPI_STATUS SNMPAPI_CALL SnmpStartup(
  [out] smiLPUINT32 nMajorVersion,
  [out] smiLPUINT32 nMinorVersion,
  [out] smiLPUINT32 nLevel,
  [out] smiLPUINT32 nTranslateMode,
  [out] smiLPUINT32 nRetransmitMode
);

매개 변수

[out] nMajorVersion

구현에서 지원하는 WinSNMP API의 주 버전 번호를 수신하기 위한 부호 없는 long 정수 변수에 대한 포인터입니다. 예를 들어 구현이 WinSNMP 버전 2.0을 지원함을 나타내기 위해 함수는 값 2를 반환합니다.

[out] nMinorVersion

구현에서 지원하는 WinSNMP API의 부 버전 번호를 수신하기 위한 부호 없는 long 정수 변수에 대한 포인터입니다. 예를 들어 구현이 WinSNMP 버전 2.0을 지원함을 나타내기 위해 함수는 값 0을 반환합니다.

[out] nLevel

구현에서 지원하는 가장 높은 수준의 SNMP 통신을 수신하기 위한 부호 없는 긴 정수 변수에 대한 포인터입니다. 반환이 성공하면 이 매개 변수에 값 2가 포함됩니다. 수준 2 지원에 대한 설명은 SNMP 지원 수준을 참조하세요.

[out] nTranslateMode

구현에 적용되는 기본 변환 모드를 수신할 부호 없는 긴 정수 변수에 대한 포인터입니다. 변환 모드는 WinSNMP 애플리케이션이 SnmpStrToEntity 함수에 전달하는 엔터티 매개 변수에 대한 구현의 해석에 적용됩니다. 변환 모드는 WinSNMP 애플리케이션이 SnmpStrToContext 함수에 전달하는 문자열 매개 변수에도 적용됩니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

값 의미
SNMPAPI_TRANSLATED
 구현은 데이터베이스를 사용하여 SNMP 엔터티 및 관리되는 개체에 대해 사용자에게 친숙한 이름을 변환합니다. 구현은 이를 SNMPv1 또는 SNMPv2C 구성 요소로 변환합니다.
SNMPAPI_UNTRANSLATED_V1
 구현은 SNMP 엔터티 매개 변수를 SNMP 전송 주소로 해석하고 컨텍스트 매개 변수를 SNMP 커뮤니티 문자열로 해석합니다. SNMPv2 대상 엔터티의 경우 구현은 버전 필드에 값이 0인 나가는 SNMP 메시지를 만듭니다.
SNMPAPI_UNTRANSLATED_V2
 구현은 SNMP 엔터티 매개 변수를 SNMP 전송 주소로 해석하고 컨텍스트 매개 변수를 SNMP 커뮤니티 문자열로 해석합니다. SNMPv2 대상 엔터티의 경우 구현은 버전 필드에 값 1이 포함된 나가는 SNMP 메시지를 만듭니다.
 

자세한 내용은 엔터티 및 컨텍스트 변환 모드 설정을 참조하세요.

[out] nRetransmitMode

구현에 적용되는 기본 재전송 모드를 수신할 부호 없는 긴 정수 변수에 대한 포인터입니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

값 의미
SNMPAPI_OFF
 구현이 WinSNMP 애플리케이션의 재전송 정책을 실행하지 않습니다.
SNMPAPI_ON
 구현은 WinSNMP 애플리케이션의 재전송 정책을 실행합니다.
 

자세한 내용은 재전송 정보를 참조하세요.

반환 값

함수가 성공하면 반환 값이 SNMPAPI_SUCCESS 매개 변수에 이전 매개 변수 설명에 표시된 대로 적절한 값이 포함됩니다.

함수가 실패하면 반환 값이 SNMPAPI_FAILURE. 확장 오류 정보를 얻으려면 세션 매개 변수에서 NULL 값을 지정하는 SnmpGetLastError를 호출합니다. SnmpGetLastError 함수는 다음 오류 중 하나를 반환할 수 있습니다. 자세한 내용은 다음 설명 섹션을 참조하세요.

반환 코드 설명
SNMPAPI_NOT_INITIALIZED
 SnmpStartup 함수가 성공적으로 완료되지 않았습니다.
SNMPAPI_ALLOC_ERROR
 메모리 할당 중에 오류가 발생했습니다.
SNMPAPI_OTHER_ERROR
 알 수 없거나 정의되지 않은 오류가 발생했습니다.

설명

WinSNMP 애플리케이션은 다른 WinSNMP 함수를 호출하기 전에 SnmpStartup 함수를 한 번 이상 성공적으로 호출해야 합니다. WinSNMP 애플리케이션이 다른 WinSNMP 함수를 호출하는 경우 SnmpStartup을 성공적으로 호출하기 전에 구현에서 오류 SNMPAPI_NOT_INITIALIZED 반환합니다.

WinSNMP 애플리케이션은 오류 정보를 위해 SnmpGetLastError 를 호출하거나 SnmpStartup 함수에 대한 호출이 실패할 경우 SnmpStartup 을 다시 시도할 수 있습니다. SnmpStartup이 SNMPAPI_FAILURE 반환하고 SnmpGetLastError에 대한 후속 호출이 SNMP_ALLOC_ERROR 반환하는 경우 WinSNMP 애플리케이션은 대기하도록 선택할 수 있습니다. 구현에 충분한 사용 가능 리소스가 있는 경우 SnmpStartup에 대한 호출을 다시 시도할 수 있습니다.

WinSNMP 애플리케이션은 SnmpStartup을 여러 번 호출할 수 있습니다. 예를 들어 앞서 설명한 이유로 함수 호출을 다시 시도해야 할 수 있습니다. 또한 WinSNMP 애플리케이션은 종료하기 전에 마지막 WinSNMP 함수 호출로 SnmpCleanup 을 한 번 이상 호출해야 합니다. 여러 SnmpStartup 호출에는 여러 SnmpCleanup 호출이 필요하지 않습니다.

자세한 내용은 SNMP 지원 수준 및 SNMP 버전 정보를 참조하세요.

요구 사항

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

추가 정보

SnmpCleanup

SnmpStrToContext

SnmpStrToEntity

WinSNMP 함수

WinSNMP API 개요