IClassFactory::LockServer
.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 método bloqueia um objeto aplicativo aberto na memória. Isso permite que novos objetos ser criados mais rapidamente.
Syntax
HRESUTL LockServer(
BOOL fLock
);
Parameters
- fLock
[no] Boolean valor que está definido como TRUE para incremento contagem de bloqueio ou FALSE para diminui a contagem de bloqueio.
Return Value
Este método oferece suporte a padrão retornam valores E_FAIL, E_OUTOFMEMORY e E_UNEXPECTED, bem como S_OK, que indica que o objeto especificado foi ambos (bloqueadafLock = TRUE) ou desbloqueada da memória (fLock = FALSE).
Remarks
IClassFactory::LockServer Controla se servidor de um objeto é mantido na memória. Manter o aplicativo Alive na memória permite instâncias que devem ser criados mais rapidamente.
Para determinar se a plataforma oferece suporte a esta interface, consulte Determinando suporte COM APIs.
Notas para chamadores
A maioria dos clientes não precisam para chamar essa função. Ele é fornecido apenas para os clientes que requerem desempenho especial na criação múltiplo instâncias de seus objetos.
Notas para Implementers
Se o contagem de bloqueio é zero, não existem objetos mais em uso e o aplicativo não é em controle de usuário, o servidor pode ser fechada.
O processo que bloqueia o aplicativo objeto é responsável por desbloqueando-lo. Uma vez o objeto classe é liberado, há um mecanismo que garante a conexão chamador para a mesma classe posterior (as in a maiúsculas e minúsculas onde um objeto classe está registrado como Single-use).
É importante para contagem todas as chamadas, não apenas o um último, para IClassFactory::LockServer, pois chamadas devem ser equilibradas antes de tentar versão o ponteiro para o IClassFactory interface no objeto de classe ou um resultados de erro.
Para cada chamar para LockServer Com fLock Definir como TRUE, deve haver um chamar para LockServer Com fLock Defina como FALSE.
Quando a contagem bloqueio e contagem de referência o objeto classe são dois zero, o objeto classe pode ser liberado.
Requirements
| Header | ocidl.h, ocidl.idl |
| Library | ole32.lib, uuid.lib |
| Windows Embedded CE | Windows CE 2.0 and later |
| Windows Mobile | Windows Mobile Version 5.0 and later |