다음을 통해 공유

SnmpMgrCtl 함수(mgmtapi.h)

  • 아티클

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

SnmpMgrCtl 함수는 SNMP 세션과 연결된 운영 매개 변수를 설정합니다. 이 함수는 SNMP 관리 API의 요소입니다.

구문

BOOL SNMP_FUNC_TYPE SnmpMgrCtl(
  [in]  LPSNMP_MGR_SESSION session,
  [in]  DWORD              dwCtlCode,
  [in]  LPVOID             lpvInBuffer,
  [in]  DWORD              cbInBuffer,
  [out] LPVOID             lpvOUTBuffer,
  [out] DWORD              cbOUTBuffer,
  [out] LPDWORD            lpcbBytesReturned
);

매개 변수

[in] session

컨트롤 코드가 적용되는 세션을 지정하는 내부 구조체에 대한 포인터입니다.

[in] dwCtlCode

수행할 작업을 식별하는 값(컨트롤 코드)을 지정합니다.

현재 MGMCTL_SETAGENTPORT 유일하게 지원되는 제어 코드입니다. 이 코드를 설정하면 SNMP 관리 애플리케이션이 임의 포트에서 SNMP 관리자 요청에 대해 "수신 대기"하는 원격 에이전트에 요청을 보낼 수 있습니다. 자세한 내용은 lpvInBuffer 및 cbInBuffer 매개 변수 설명을 참조하세요.

[in] lpvInBuffer

작업에 필요한 입력 매개 변수를 포함하는 버퍼에 대한 포인터입니다.

MGMCTL_SETAGENTPORT 제어 코드를 지정할 때 이 매개 변수는 원격 에이전트가 SNMP 관리자 요청에 대해 "수신 대기"할 포트 번호를 지정하는 부호 없는 정수를 가리킵니다. 포트 번호는 호스트 바이트 순서여야 합니다.

[in] cbInBuffer

lpvInBuffer 매개 변수가 가리키는 버퍼의 크기(바이트)를 지정합니다.

MGMCTL_SETAGENTPORT 제어 코드를 지정하면 이 매개 변수는 sizeof(UINT)와 같습니다.

[out] lpvOUTBuffer

작업의 출력 데이터를 수신하는 버퍼에 대한 포인터입니다.

[out] cbOUTBuffer

lpvOutBuffer 매개 변수가 가리키는 버퍼의 크기(바이트)를 지정합니다.

[out] lpcbBytesReturned

lpvOutBuffer 매개 변수가 가리키는 버퍼에 저장된 데이터의 실제 크기(바이트)를 수신하는 변수에 대한 포인터입니다.

반환 값

함수가 성공하면 반환 값이 0이 아닙니다.

함수가 실패하면 반환 값은 0입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다. GetLastError 는 다음 오류 코드 중 하나를 반환할 수도 있습니다.

반환 코드 설명
SNMP_MGMTAPI_INVALID_CTL
 dwCtlCode 매개 변수는 유효한 제어 코드를 지정하지 않습니다.
SNMP_MGMTAPI_INVALID_SESSION
 세션 매개 변수는 유효한 SNMP 세션을 지정하지 않습니다.
SNMP_MGMTAPI_INVALID_BUFFER
 하나 이상의 lpvInBuffer, lpvOutBuffer 또는 lpcbBytesRequired 매개 변수가 잘못되었거나 cbInBuffer 또는 cbOutBuffer 매개 변수가 너무 작습니다.

요구 사항

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

참고 항목

SNMP 함수

SNMP(Simple Network Management Protocol) 개요

SnmpMgrOpen