SnmpStrToContext 함수(winsnmp.h)
[SNMP는 요구 사항 섹션에 지정된 운영 체제에서 사용할 수 있습니다. 이후 버전에서는 변경되거나 제공되지 않을 수 있습니다. 대신 WS-Man의 Microsoft 구현인 Windows 원격 관리를 사용합니다.]
WinSNMP SnmpStrToContext 함수는 Microsoft WinSNMP 구현과 관련된 SNMP 컨텍스트 정보에 대한 핸들을 반환합니다. 핸들은 WinSNMP 애플리케이션이 SnmpSendMsg 및 SnmpRegister 함수 호출에서 컨텍스트 매개 변수로 사용할 수 있는 유효한 값입니다.
구문
HSNMP_CONTEXT SNMPAPI_CALL SnmpStrToContext(
[in] HSNMP_SESSION session,
[in] smiLPCOCTETS string
);
매개 변수
[in] session
WinSNMP 세션에 대한 핸들입니다.
[in] string
해석할 문자열을 포함하는 smiOCTETS 구조체에 대한 포인터입니다. 문자열은 관리되는 개체의 컬렉션을 식별하거나 커뮤니티 문자열일 수 있습니다.
엔터티 및 컨텍스트 변환 모드의 현재 설정은 다음 표와 같이 SnmpStrToContext 가 입력 문자열 구조를 해석하는 방법을 결정합니다.
반환 값
함수가 성공하면 반환 값은 관심 있는 컨텍스트에 대한 핸들입니다.
함수가 실패하면 반환 값이 SNMPAPI_FAILURE. 확장된 오류 정보를 얻으려면 SnmpGetLastError를 호출합니다. SnmpGetLastError 함수는 다음 오류 중 하나를 반환할 수 있습니다.
| 반환 코드 | 설명 |
|---|---|
|
SnmpStartup 함수가 성공적으로 완료되지 않았습니다. |
|
메모리 할당 중에 오류가 발생했습니다. |
|
세션 매개 변수가 잘못되었습니다. |
|
문자열 매개 변수 형식이 잘못되었습니다. 예를 들어 문자열 매개 변수가 가리키는 smiOCTETS 구조체의 len 멤버 또는 ptr 멤버는 NULL입니다. |
|
문자열 매개 변수에서 참조되는 값이 없습니다. |
|
알 수 없거나 정의되지 않은 오류가 발생했습니다. |
설명
엔터티 및 컨텍스트 변환 모드의 현재 설정은 SnmpStrToContext 가 입력 문자열 구조를 해석하는 방식을 결정합니다. 자세한 내용은 엔터티 및 컨텍스트 변환 모드 설정을 참조하세요.
WinSNMP 애플리케이션은 SnmpFreeContext 함수를 호출하여 SnmpStrToContext 함수에 의해 할당된 컨텍스트 핸들을 해제해야 합니다. 리소스 릴리스에 대한 자세한 내용은 WinSNMP 데이터 관리 개념을 참조하세요.
WinSNMP 애플리케이션은 문자열 매개 변수가 가리키는 smiOCTETS 구조체의 ptr 멤버와 연결된 메모리를 해제해야 합니다. 이는 애플리케이션이 리소스를 정의하고 할당하기 때문입니다. 예를 들어 애플리케이션이 GlobalAlloc 함수를 호출하여 리소스를 할당한 경우 GlobalFree 함수를 사용하여 리소스의 할당을 취소해야 합니다. 자세한 내용은 WinSNMP 설명자 해제를 참조하세요.
요구 사항
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | winsnmp.h |
| 라이브러리 | Wsnmp32.lib |
| DLL | Wsnmp32.dll |