DmiRemoteUnregister(3dmi)

DmiRemoteUnregister -- close a session with a remote Service Provider

Synopsis

#include <dmionc.h>

DmiErrorStatus_t DMI_API DmiRemoteUnregister (
	DmiHandle_t handle);

DmiErrorStatus_t DMI_API DmiUnregister (
	DmiHandle_t handle);

Description

Management applications use the DmiRemoteUnregister function to close a session with the remote Service Provider. To specify a session, the application supplies a session handle received from the DmiRemoteRegister(3dmi) or DmiRegister(3dmi) functions. DmiRemoteUnregister or DmiUnregister must be the last DMI command in a session. To close a session with the remote Service Provider, the client software sends the DmiUnregister command to the Service Provider, which then performs end-of-session cleanup actions. When DmiUnregister/DmiRemoteUnregsiter return, the handle is invalid.

Parameters

handle (Input) Session handle returned by the DmiRemoteRegister or DmiRegister functions.

Return values

DMIERR_NO_ERROR
DMIERR_ILLEGAL_HANDLE
DMIERR_OUT_OF_MEMORY
DMIERR_INSUFFICIENT_PRIVILEGES
DMIERR_SP_INACTIVE
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.