man pages section 3: Extended Library Functions, Volume 2

IMA_GetAssociatedPluginOid (3IMA)

Name

IMA_GetAssociatedPluginOid - Gets the object ID for a plugin associated with the specified object ID

Synopsis

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

IMA_STATUS IMA_GetAssociatedPluginOid(
 /* in */      IMA_OID oid
 /* out */     IMA_OID *pPluginOid
);

Parameters

oid

The ID of an object that has been received from a previous API call.

pPluginOid

A pointer to an IMA_OID data structure allocated by the caller.

If this argument is successfully returned, it contains the object ID of a plugin associated with the object specified by the oid argument. The object ID of the plugin can then be used to perform tasks associated with the plugin, such as getting the properties of the plugin, or sending the plugin an IOCtl (input/output control) call.

Description

The IMA_GetAssociatedPluginOid() API gets the object ID for the plugin associated with the object specified in the oid argument.

Return Values

IMA_ERROR_INVALID_PARAMETER

• Returned if the oid argument specifies an object owned by the library instead of an object owned by a plugin

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

IMA_ERROR_INVALID_OBJECT_TYPE

Returned if the oid argument specifies an object with an invalid type

IMA_ERROR_OBJECT_NOT_FOUND

Returned if the oid argument does not specify a plugin known to the system

IMA_ERROR_PLUGINS_NOT_SUPPORTED

Returned if the library implementation does not support plugins

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_PluginIOCtl(3IMA)