SnmpStrToEntity 함수(winsnmp.h)

아티클
03/15/2023

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

WinSNMP SnmpStrToEntity 함수는 Microsoft WinSNMP 구현과 관련된 SNMP 관리 엔터티에 대한 정보에 대한 핸들을 반환합니다.

구문

HSNMP_ENTITY SNMPAPI_CALL SnmpStrToEntity(
  [in] HSNMP_SESSION session,
  [in] LPCSTR        string
);

매개 변수

[in] session

WinSNMP 세션에 대한 핸들입니다.

[in] string

관심 있는 SNMP 관리 엔터티를 식별하는 null로 끝나는 문자열에 대한 포인터입니다. 엔터티 및 컨텍스트 변환 모드의 현재 설정은 SnmpStrToEntity 가 입력 문자열을 다음과 같이 해석하는 방식을 결정합니다.

엔터티/컨텍스트 변환 모드	의미
SNMPAPI_TRANSLATED	구현은 문자열 매개 변수를 사용자에게 친숙한 이름으로 해석합니다. 구현은 구현의 데이터베이스를 사용하여 이름을 SNMPv1 또는 SNMPv2C 구성 요소로 변환합니다.
SNMPAPI_UNTRANSLATED_V1	구현은 문자열 매개 변수를 리터럴 SNMP 전송 주소로 해석합니다.
SNMPAPI_UNTRANSLATED_V2	구현은 문자열 매개 변수를 리터럴 SNMP 전송 주소로 해석합니다.

반환 값

함수가 성공하면 반환 값은 관심 있는 SNMP 관리 엔터티에 대한 핸들입니다.

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

반환 코드	설명
SNMPAPI_NOT_INITIALIZED	SnmpStartup 함수가 성공적으로 완료되지 않았습니다.
SNMPAPI_ALLOC_ERROR	메모리 할당 중에 오류가 발생했습니다.
SNMPAPI_SESSION_INVALID	세션 매개 변수가 잘못되었습니다.
SNMPAPI_ENTITY_UNKNOWN	엔터티 문자열이 잘못되었습니다.
SNMPAPI_OTHER_ERROR	알 수 없거나 정의되지 않은 오류가 발생했습니다.

설명

엔터티 및 컨텍스트 변환 모드의 현재 설정은 SnmpStrToEntity 가 관심 있는 관리 엔터티를 식별하는 입력 문자열을 해석하는 방식을 결정합니다. 자세한 내용은 WinSNMP의 IPX 주소 문자열 지원 및 엔터티 및 컨텍스트 변환 모드 설정을 참조하세요.

WinSNMP 애플리케이션은 SnmpFreeEntity 함수를 호출하여 SnmpStrToEntity 함수에 의해 할당된 엔터티 핸들을 해제해야 합니다. 자세한 내용은 WinSNMP 데이터 관리 개념을 참조하세요.

SnmpStrToEntity 함수는 WinSNMP 애플리케이션이 여러 WinSNMP 함수에서 srcEntity 또는 dstEntity 매개 변수로 사용할 수 있는 유효한 엔터티 핸들을 반환합니다. 이러한 함수에는 SnmpSendMsg, SnmpRecvMsg, SnmpRegister, SnmpEncodeMsg 및 SnmpDecodeMsg 함수가 포함됩니다.

구현은 SnmpStartup 함수의 nTranslateMode 매개 변수에서 현재 엔터티 및 컨텍스트 변환 모드를 반환합니다. WinSNMP 애플리케이션은 SnmpSetTranslateMode 함수를 호출하여 엔터티 및 컨텍스트 변환 모드의 설정을 변경할 수 있습니다.

요구 사항

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