CoAddRefServerProcess

9/8/2008

Essa função incrementa uma global por-processo contagem de referência.

Syntax

ULONG CoAddRefServerProcess(void);

Parameters

Nenhum.

Return Value

• S_OK
  O CLSID foi recuperada com êxito.

Remarks

Os servidores podem chamar CoAddRefServerProcess Para incremento um global por-processo contagem de referência.

Essa função é particularmente útil para servidores que são implementados com múltiplo segmentos, ou multi-apartmented-segmentação livre. Servidores de esses tipos deve coordenar a decisão desligado com ativação solicitações entre múltiplo segmentos.

Chamando CoAddRefServerProcess incrementa uma global por-processo contagem de referência e chamado CoReleaseServerProcess diminui essa contagem.

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 prestar atenção à código de retorno de CoReleaseServerProcess e se ela retorna 0, o aplicativo servidor deve iniciar seu limpeza, que, para um servidor com múltiplo segmentos, geralmente significa que ele deve sinal seus vários segmentos para sair sua mensagem loops e chamar CoRevokeClassObject e CoUninitialize.

Se essas funções 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 ser prematuramente desligar. 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

See Also

Reference

COM Functions