다음을 통해 공유

SnmpMgrRequest 함수(mgmtapi.h)

  • 아티클

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

SnmpMgrRequest 함수는 지정된 에이전트를 사용하여 지정된 작업을 수행할 것을 요청합니다. 이 함수는 SNMP 관리 API의 요소입니다.

구문

SNMPAPI SNMP_FUNC_TYPE SnmpMgrRequest(
  [in]      LPSNMP_MGR_SESSION session,
  [in]      BYTE               requestType,
  [in, out] RFC1157VarBindList *variableBindings,
  [out]     AsnInteger         *errorStatus,
  [out]     AsnInteger         *errorIndex
);

매개 변수

[in] session

요청을 수행할 세션을 지정하는 내부 구조에 대한 포인터입니다.

애플리케이션은 다른 스레드에서 이 함수가 반환하는 LPSNMP_MGR_SESSION 포인터를 지정해서는 안 됩니다. SnmpMgrOpen에서 반환된 포인터를 지정할 수 있지만 SnmpMgrOpen 및 SnmpMgrRequest에 대한 호출이 동일한 스레드의 컨텍스트에서 시작된 경우에만 지정할 수 있습니다.

[in] requestType

SNMP 요청 유형을 지정합니다. 이 매개 변수는 SNMPv1에서 정의한 다음 값 중 하나일 수 있습니다.

값 의미
SNMP_PDU_GET
 지정된 변수의 값 또는 값을 검색합니다.
SNMP_PDU_GETNEXT
 지정한 변수의 사전순 후임자 값 또는 값을 검색합니다.
SNMP_PDU_SET
 특정 변수 내에 값을 씁니다.
 

PDU 요청 형식의 이름이 변경되었습니다. 자세한 내용은 SNMP 변수 형식 및 요청 PDU 형식을 참조하세요.

[in, out] variableBindings

변수 바인딩 목록에 대한 포인터입니다.

참고SnmpVarBindList 구조체가 가리키는 SnmpVarBind 배열은 SnmpUtilMemAlloc 함수를 사용하여 할당해야 합니다.
 

[out] errorStatus

오류 상태 결과가 반환되는 변수에 대한 포인터입니다. 이 매개 변수는 SNMPv1에서 정의한 다음 값 중 하나일 수 있습니다.

값 의미
SNMP_ERRORSTATUS_NOERROR
 에이전트는 전송 중에 오류가 발생하지 않았다고 보고합니다.
SNMP_ERRORSTATUS_TOOBIG
 에이전트가 요청된 작업의 결과를 단일 SNMP 메시지에 배치할 수 없습니다.
SNMP_ERRORSTATUS_NOSUCHNAME
 요청된 작업에서 알 수 없는 변수를 식별했습니다.
SNMP_ERRORSTATUS_BADVALUE
 요청된 작업이 변수를 변경하려고 했지만 구문 또는 값 오류를 지정했습니다.
SNMP_ERRORSTATUS_READONLY
 요청된 작업은 변수의 커뮤니티 프로필에 따라 변경할 수 없는 변수를 변경하려고 했습니다.
SNMP_ERRORSTATUS_GENERR
 여기에 나열된 오류 중 하나 이외의 오류가 요청된 작업 중에 발생했습니다.

[out] errorIndex

오류 인덱스 결과가 반환될 변수에 대한 포인터입니다.

반환 값

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

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

반환 코드 설명
SNMP_MGMTAPI_TIMEOUT
 요청 시간이 초과되었습니다.
SNMP_MGMTAPI_SELECT_FDERRORS
 Windows 소켓 선택 함수에서 나타내는 예기치 않은 오류 파일 설명자입니다.

설명

다시 시도 및 시간 제한은 SnmpMgrOpen 함수에 제공됩니다. 변수 바인딩 목록의 각 변수를 초기화하여 Get 및 Get Next 요청에 대한 ASN_NULL 입력해야 합니다.

요구 사항

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

추가 정보

SNMP 함수

SNMP(Simple Network Management Protocol) 개요

SnmpMgrClose

SnmpMgrOpen