SnmpSetTranslateMode 함수(winsnmp.h)

아티클
03/15/2023

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

WinSNMP SnmpSetTranslateMode 함수를 사용하면 WinSNMP 애플리케이션이 엔터티 및 컨텍스트 변환 모드를 변경할 수 있습니다. 엔터티 및 컨텍스트 변환 모드는 WinSNMP 입력 및 출력 문자열 매개 변수의 해석 및 반환에 영향을 줍니다.

구문

SNMPAPI_STATUS SNMPAPI_CALL SnmpSetTranslateMode(
  [in] smiUINT32 nTranslateMode
);

매개 변수

[in] nTranslateMode

새 엔터티 및 컨텍스트 변환 모드의 값을 지정합니다. 이 매개 변수는 다음 값 중 하나여야 합니다.

값	의미
SNMPAPI_TRANSLATED	Microsoft WinSNMP 구현은 데이터베이스를 사용하여 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. 확장 오류 정보를 얻으려면 세션 매개 변수에서 NULL 값을 지정하는 SnmpGetLastError를 호출합니다. SnmpGetLastError 함수는 다음 오류 중 하나를 반환할 수 있습니다.

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

설명

새 엔터티 및 컨텍스트 변환 모드는 SnmpStrToEntity, SnmpStrToContext, SnmpContextToStr 및 SnmpEntityToStr 함수에 대한 후속 호출에 영향을 줍니다. WinSNMP 애플리케이션은 다른 nTranslateMode 값으로 SnmpSetTranslateMode를 다시 호출하여 엔터티 및 컨텍스트 변환 모드를 다시 변경할 수 있습니다.

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

요구 사항

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