CoReleaseServerProcess
.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.")
.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.")
9/8/2008
Este decrementa função global por-processo contagem de referência
Syntax
ULONG CoReleaseServerProcess(void);
Parameters
Nenhum.
Return Value
- 0
O aplicativo servidor deve iniciar seu limpeza.
- Outros valores
Aplicativo de servidor não deve ainda iniciar sua limpeza.
Remarks
Os servidores podem chamar CoReleaseServerProcess a diminuição um global por-contagem de referência processo incrementado por um chamar para CoAddRefServerProcess.
Quando essa contagem atinge zero, chamadas automaticamente OLE CoSuspendClassObjects, que impede que novas solicitações ativação. Isso permite que o servidor para cancelar seus objetos classe de seus vários segmentos sem preocupações que outro solicitação de ativação pode vir no. Ativação nova solicitações resultam em iniciando uma nova instância do local processo servidor.
A maneira mais simples para um local aplicativo servidor para fazer uso dessas funções API é chamar CoAddRefServerProcess No construtor para cada um dos seus objetos instância e em cada um dos seus IClassFactory::LockServer Métodos quando o fLock parâmetro é TRUE.
O aplicativo servidor também deve chamar CoReleaseServerProcess Na destruição de cada um dos seus objetos instância e em cada um dos seus IClassFactory::LockServer Métodos quando o fLock parâmetro é FALSE.
Finalmente, o aplicativo servidor deve verificar a código de retorno de CoReleaseServerProcess; Se ela retorna 0, o aplicativo servidor deve iniciar seu limpeza. Este geralmente significa que um servidor com múltiplo segmentos devem sinal seus vários segmentos para sair sua mensagem loops e chamar CoRevokeClassObject e CoUninitialize.
Se essas APIs são usadas em todos os, eles devem ser chamado em ambas as instâncias as objeto e o LockServer método, caso contrário o aplicativo servidor pode estar desligamento prematuramente. No-servidores processo geralmente deve chamar não CoAddRefServerProcess Ou CoReleaseServerProcess.
Para determinar se a plataforma oferece suporte a essa função, consulte Determinando suporte COM APIs.
Requirements
| Header | objbase.h |
| Library | ole32.lib |
| Windows Embedded CE | Windows CE 3.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |