ICcService::UnlockService
Other versions of this page are also available for the following:
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
8/27/2008
This method decrements the lock count for the service.
Syntax
HRESULT UnlockService()
Parameters
None.
Return Value
The following table shows return values for this method.
| Value | Description |
|---|---|
S_OK |
Indicates success. |
E_FAIL |
Indicates failure. |
Remarks
If the lock count of the service goes to 0, a service host is signaled to clear this service from its internal cache.
A client calls this API explicitly before releasing a service if the client obtained the service via a service host.
If the client created the service directly, the client should call this API only if the client also called ICcService::LockService.
This method translates to no-op if the lock count is zero.
If this 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 still call UnlockService before they release the service.
Requirements
| Header | ccservice.h |
| Windows Embedded CE | Windows CE 5.0 and later |