Service

Overview

Related Modules:

Samgr

Description:

Indicates the basic type of a service.

You need to implement the function pointers of Service.

Summary

Data Fields

Details

Field Documentation

GetName

const char*(* Service::GetName) ([Service](Service.md) *service)

Description:

Obtains the name of a service.

This function is called by Samgr during service registration and startup. You need to implement this function.

Parameters:

Returns:

Returns a constant string no more than 16 bytes if the service name is obtained successfully; returns NULL if the service name fails to be obtained.

GetTaskConfig

[TaskConfig](TaskConfig.md)(* Service::GetTaskConfig) ([Service](Service.md) *service)

Description:

Obtains task configurations of a service.

This function is used to return task configurations. You need to implement this function.

Parameters:

Returns:

Returns TaskConfig.

Initialize

BOOL(* Service::Initialize) ([Service](Service.md) *service, [Identity](Identity.md) identity)

Description:

Initializes the service.

After Samgr assigns tasks to a service, the service calls the function in its own tasks. You need to implement this function.

Parameters:

Returns:

Returns TRUE if the initialization is successful; returns FALSE otherwise.

MessageHandle

BOOL(* Service::MessageHandle) ([Service](Service.md) *service, [Request](Request.md) *request)

Description:

Processes service messages.

This function is used to process requests sent by the caller through IUnknown. You need to implement this function.

Parameters:

Returns:

Returns TRUE if the message processing is successful; returns FALSE if the processing fails.