MprAdminMIBSetTrapInfo function (mprapi.h)

The MprAdminMIBSetTrapInfo function specifies a handle to an event that is signaled whenever a TRAP needs to be issued.

Syntax

DWORD MprAdminMIBSetTrapInfo(
  [in]      DWORD   dwProtocolId,
  [in]      DWORD   dwRoutingPid,
  [in]      HANDLE  hEvent,
  [in]      LPVOID  lpInData,
  [in]      DWORD   dwInDataSize,
  [out]     LPVOID  *lplpOutData,
  [in, out] LPDWORD lpOutDataSize
);

Parameters

[in] dwProtocolId

Specifies a DWORD variable that contains the protocol family identifier.

[in] dwRoutingPid

Specifies a DWORD variable that contains the identifier of the routing protocol.

[in] hEvent

Handle to an event that is signaled when a trap needs to be issued.

[in] lpInData

Pointer to the input data.

[in] dwInDataSize

Specifies a DWORD variable that contains the size in bytes of the data pointed to by lpInData.

[out] lplpOutData

Receives the address of a pointer to the output data.

[in, out] lpOutDataSize

On input, pointer to a DWORD variable.

On output, receives the size, in bytes, of the data pointed to by * lplpOutData.

Return value

If the functions succeeds, the return value is NO_ERROR

If the function fails, the return value is one of the following error codes.

Value	Description
ERROR_ACCESS_DENIED	The caller does not have sufficient privileges.
ERROR_UNKNOWN_PROTOCOL_ID	The dwTransportId value does not match any installed router manager.
ERROR_NOT_ENOUGH_MEMORY	Insufficient resources to complete the operation.

Requirements

Requirement	Value
Minimum supported client	None supported
Minimum supported server	Windows 2000 Server [desktop apps only]
Target Platform	Windows
Header	mprapi.h
DLL	Mprapi.dll

See also

MprAdminMIBGetTrapInfo

Router Management MIB Functions

Router Management MIB Reference

Transport and Protocol Constants