man pages section 3: Extended Library Functions, Volume 2

IMA_GetIpsecProperties (3IMA)

Name

IMA_GetIpsecProperties - Gets the IPsec properties of the specified PNP or LHBA

Synopsis

cc [ flag... ] file... -lima [ library... ]
#include <ima.h>

IMA_STATUS IMA_GetIpsecProperties(
  /* in */     IMA_OID oid,
  /* out */    IMA_IPSEC_PROPERTIES *pProps
);

Parameters

phbaOid

The object ID of the physical network port (PNP) or logical host bus adapter (LHBA) whose IPsec properties are being retrieved.

pProps

A pointer to an IMA_IPSEC_PROPERTIES data structure allocated by the caller. If successfully returned, this structure contains the IPsec properties of the specified PNP or LHBA object.

Description

The IMA_GetIpsecProperties() API gets the IPsec properties of the specified PNP or LHBA object.

Return Values

IMA_ERROR_INVALID_PARAMETER

Returned if the pProps argument is NULL, or specifies a memory area to which data cannot be written

IMA_ERROR_INVALID_OBJECT_TYPE

Returned if the phbaOid argument does not specify a valid object type

IMA_ERROR_INCORRECT_OBJECT_TYPE

Returned if the phbaOid argument does not specify a PNP or LHBA object

IMA_ERROR_OBJECT_NOT_FOUND

Returned if the phbaOid argument does not specify a PNP or LHBA known to the system

Attributes

See attributes(7) for descriptions of the following attributes:

ATTRIBUTE TYPE ATTRIBUTE VALUE Availability system/library/storage/snia-ima Interface Stability Volatile MT-Level Safe

See Also

libima(3LIB), attributes(7), IMA_GetLhbaOidList(3IMA), IMA_GetPnpOidList(3IMA)