op_pk_nfd_get_objid()
Abstract
Obtains the value of an object ID field in the specified packet, changing the status of some field types to unset; the field-of-interest is specified by name.
Syntax
op_pk_nfd_get_objid (pkptr, fd_name, value_ptr)
| Argument | Type | Description |
|---|---|---|
pkptr |
Packet* |
packet-of-interest [A pointer to a packet can be obtained from many KPs, including op_pk_create_fmt(), op_pk_copy(), op_pk_get(), op_subq_pk_access(), and op_subq_pk_remove().] |
fd_name |
const char* |
name of the field-of-interest [This name must be a defined field within the packet's format, or an error will occur.] |
value_ptr |
Objid* |
variable to be filled with the specified field's value |
Return Type
Compcode
OPC_COMPCODE_SUCCESS if the value of the field can be obtained; OPC_COMPCODE_FAILURE otherwise.
Example
/* variable declarations */
Objid prev_node_id; Packet *pkptr;
/* Obtain the node identifier of the node which */
/* forwarded this frame to the current node. */
op_pk_nfd_get_objid (pkptr, "prev node id", &prev_node_id);
Details
None.
Purpose
Provides a way to obtain the value of a packet field. This KP works identically to op_pk_nfd_get(), but applies only to packet fields of data type object ID. Refer to op_pk_nfd_get() for full purpose and details.
Errors
- Same as op_pk_nfd_get().
Reference
- Same as op_pk_nfd_get().