DmiRemoteRegister(3dmi)

DmiRemoteRegister -- open a session with a remote Service Provider

Synopsis

#include <dmionc.h>

DmiErrorStatus_t DMI_API DmiRemoteRegister (
	DmiHandle_t * handle,
	DmiNodeAddress_t * node);

Description

Management applications use the DmiRemoteRegister function to open a session with the remote Service Provider specified by node = { address, rpc, transport}. You must issue the DmiRemoteRegister or DmiRegister functions before any other DMI command is sent to the specified Service Provider. The DMI Service Provider uses this function to initialize its internal state for subsequent calls made by the application.

Parameters

handle: (Output) Unique per-session handle that must be used in all subsequent DMI commands.
node: (Input) Remote Service Provider with which to register.

Return values

DMIERR_NO_ERROR
DMIERR_OUT_OF_MEMORY
DMIERR_INSUFFICIENT_PRIVILEGES
DMIERR_SP_INACTIVE
DMIERR_CFE_RPC_NOT_SUPPORTED
DMIERR_RPC_INVALID_ADDRESS
DMIERR_RPC_TRANSPORT_UNAVAILABLE
DMIERR_RPC_SERVER_UNAVAILABLE
DMIERR_RPC_LOW_RESOURCES

For a description of return values, see ``DMI error codes'' in Desktop Management Interface programming.

Notices

Portions of this page are derived from material for which the copyright owner is Intel Corporation, Inc. The material is reprinted with permission. See copyright page for a full statement of rights and permissions.