다음을 통해 공유

SnmpSetPort 함수(winsnmp.h)

  • 아티클

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

WinSNMP 애플리케이션은 SnmpSetPort 함수를 호출하여 대상 엔터티에 할당된 포트를 변경합니다. SnmpSetPort 함수는 WinSNMP API 버전 2.0의 요소입니다.

구문

SNMPAPI_STATUS SNMPAPI_CALL SnmpSetPort(
  [in] HSNMP_ENTITY hEntity,
  [in] UINT         nPort
);

매개 변수

[in] hEntity

WinSNMP 대상 엔터티에 대한 핸들입니다. 이 매개 변수는 SnmpListen 함수 호출의 결과로 SNMP 에이전트 애플리케이션의 역할에서 작동하는 엔터티에 대한 핸들을 지정할 수 있습니다. 자세한 내용은 아래 설명 부분을 참조하십시오.

[in] nPort

대상 엔터티에 대한 새 포트 할당을 식별하는 부호 없는 정수 를 지정합니다. 사용 중인 로컬 주소를 지정하거나 사용할 수 없는 원격 주소를 지정하면 SnmpSetPort 함수에 대한 호출이 실패합니다.

반환 값

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

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

반환 코드 설명
SNMPAPI_NOT_INITIALIZED
 SnmpStartup 함수가 성공적으로 완료되지 않았습니다.
SNMPAPI_OPERATION_INVALID
 hEntity 매개 변수로 지정된 엔터티가 SnmpListen 함수에 대한 호출의 결과로 에이전트 역할에서 이미 작동하고 있습니다. 자세한 내용은 아래 설명 부분을 참조하십시오.
SNMPAPI_ENTITY_INVALID
 hEntity 매개 변수가 잘못되었습니다. 이 매개 변수는 SnmpStrToEntity 함수에 대한 이전 호출에서 반환된 핸들이어야 합니다.
SNMPAPI_OTHER_ERROR
 알 수 없거나 정의되지 않은 오류가 발생했습니다.

설명

Microsoft WinSNMP 구현은 WinSNMP 애플리케이션이 SnmpStrToEntity 함수를 호출한 결과로 각 관리 엔터티에 포트를 할당합니다. 구현에서 엔터티를 만들 때 SNMPAPI_UNTRANSLATED 모드가 적용되는 경우 구현은 일반적으로 해당 프로토콜 패밀리에 대한 표준 SNMP 요청 포트를 엔터티에 할당합니다. 예를 들어 UDP 161 또는 IPX 36879입니다. SNMPAPI_TRANSLATED 모드가 적용되는 경우 구현은 WinSNMP 데이터베이스의 엔터티에 대해 지정된 포트를 할당합니다. 구현에 적용되는 현재 엔터티 및 컨텍스트 변환 모드를 검색하기 위해 애플리케이션은 SnmpGetTranslateMode 함수를 호출할 수 있습니다. 자세한 내용은 엔터티 및 컨텍스트 변환 모드 설정 및WinSNMP 데이터베이스를 참조하세요.

hEntity 매개 변수로 지정된 엔터티가 현재 에이전트 역할에서 작동하는 경우 SnmpSetPort 함수에 대한 호출이 실패합니다. 엔터티가 nPort 매개 변수로 지정된 포트 이외의 포트에 이미 할당되었기 때문입니다. 특정 포트에 에이전트 애플리케이션을 할당하기 위해 WinSNMP 애플리케이션은 다음 단계를 수행할 수 있습니다.

  1. 다음과 같이 SnmpStrToEntity 를 호출합니다.

    hAgent = SnmpStrToEntity (hSession, <addrString>);

  2. 다음과 같이 SnmpSetPort 를 호출합니다.

    SnmpSetPort (hAgent, <nPort>);

  3. 다음과 같이 SnmpListen 을 호출합니다.

    SnmpListen (hAgent, SNMPAPI_ON);

여기서 <addrString> 은 IP 주소 또는 IPX 주소 <의 문자열 표현을 포함하고 nPort> 에는 에이전트 애플리케이션에 대한 새 포트 할당이 포함됩니다.

IPX 주소에는 8개의 16진수 숫자(필요한 경우 0으로 채워짐)로 구성된 네트워크 번호가 포함되어 있습니다. 구분 기호(":", "." 또는 " – "); 12개의 16진수(필요한 경우 0으로 채워짐)로 구성된 노드 번호(예: 00000001:00081A0D01C2). 자세한 내용은 WinSNMP의 IPX 주소 문자열 지원을 참조하세요.

요구 사항

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

추가 정보

SnmpGetTranslateMode

SnmpListen

SnmpStrToEntity

WinSNMP 함수

WinSNMP API 개요