SnmpGetTranslateMode 함수(winsnmp.h)

아티클
03/13/2024

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

WinSNMP SnmpGetTranslateMode 함수는 엔터티 및 컨텍스트 변환 모드의 현재 설정을 WinSNMP 애플리케이션으로 반환합니다. 엔터티 및 컨텍스트 변환 모드는 WinSNMP 입력 및 출력 문자열 매개 변수의 해석 및 반환에 영향을 줍니다.

구문

SNMPAPI_STATUS SNMPAPI_CALL SnmpGetTranslateMode(
  [out] smiLPUINT32 nTranslateMode
);

매개 변수

[out] nTranslateMode

Microsoft WinSNMP 구현에 적용되는 엔터티 및 컨텍스트 변환 모드를 수신하기 위한 부호 없는 긴 정수 변수에 대한 포인터입니다. 이 매개 변수는 다음 값 중 하나일 수 있습니다.

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

반환 값

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

함수가 실패하면 반환 값이 SNMPAPI_FAILURE. SnmpGetTranslateMode가 실패하면 nTranslateMode 매개 변수의 값은 애플리케이션에 아무런 의미가 없습니다. 확장 오류 정보를 얻으려면 세션 매개 변수에 NULL 값을 지정하는 SnmpGetLastError를 호출합니다. SnmpGetLastError 함수는 다음 오류 중 하나를 반환할 수 있습니다.

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

설명

엔터티 및 컨텍스트 변환 모드는 SnmpStrToEntity, SnmpStrToContext, SnmpContextToStr 및 SnmpEntityToStr 함수에 대한 호출에 영향을 줍니다. 자세한 내용은 엔터티 및 컨텍스트 변환 모드 설정을 참조하세요.

요구 사항

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