ICcService::LockService (Compact 2013)

3/26/2014

Deprecated.

This method increments the lock count of the service. Lock count of the service is equal to the number of external clients who have reference to this service.

Syntax

HRESULT LockService()

Return Value

The following table shows the return values for this service.

Value

Description

S_OK

Indicates success.

E_FAIL

Indicates failure.

Remarks

The lock count of a service is the count of external clients who have access to this service object.

The lock count controls the service lifetime within the service host process, based on the count of external clients.

A Core Connectivity service host calls this method whenever clients request a service through ICcSvcHost::GetService.

Clients should not call this method directly, unless they create the service without going through the service host.

If the service is loaded by the service host, LockService is called by the service host on behalf of external clients when external clients call ICcSvcHost::GetService.

Clients must call ICcService::UnlockService before they release the service.

Requirements

Header

ccservice.h

See Also

Reference

ICcService
Core Connectivity Interfaces