man pages section 3: Extended Library Functions, Volume 2

IMA_GetObjectType (3IMA)

Name

IMA_GetObjectType - Gets the object type of an initialized object ID

Synopsis

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

IMA_STATUS IMA_GetObjectType(
 /* in */       IMA_OID oid,
 /* out */      IMA_OBJECT_TYPE *pObjectType
);

Parameters

oid

The initialized object ID whose type is retrieved.

pObjectType

A pointer to an IMA_OBJECT_TYPE variable allocated by the caller. If returned successfully, this variable contains the object type of the oid argument.

Description

The IMA_GetObjectType() API gets the object type of an initialized object ID.

Return Values

IMA_ERROR_INVALID_PARAMETER

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

IMA_ERROR_INVALID_OBJECT_TYPE

Returned if the oid argument does not specify a valid object type. This is most likely to happen if an uninitialized object ID is passed to the API.

IMA_ERROR_OBJECT_NOT_FOUND

Returned if the oid argument has an owner not 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_RegisterForObjectVisibilityChanges(3IMA)