IOleContainer::LockContainer

9/8/2008

Mantém contêiner de um objeto incorporado execução.

Syntax

HRESULT LockContainer( 
  BOOL fLock  //Value indicating lock or unlock
);

Parameters

• fLock
  [no] Valor que especifica se deve ser bloqueio (TRUE) ou desbloquear (FALSE) um contêiner.

Return Value

Este método oferece suporte a seguinte valores de retorno:

Valor	Descrição
S_OK	O contêiner foi bloqueado com êxito.
E_OUTOFMEMORY	O chamar não pode ser concluída porque o programa tiver executar memória insuficiente.
E_FAIL	A chamar a falha de método.

Remarks

Chama um objeto incorporado IOleContainer::LockContainer Para manter seu contêiner execução quando o objeto tem clientes link que requerem uma atualização. Se um usuário final seleciona arquivos Fechar do menu do contêiner, no entanto, o contêiner ignorará todos os pendente LockContainer Bloqueia e fecha o documento mesmo assim.

Notas para chamadores

Quando um objeto incorporado muda da carregado para a execução estado, ele deve chamar IOleContainer::LockContainer Com o parâmetro fLock definido como TRUE. Quando o objeto incorporado desligado (transições de execução para carregado), ele deve chamar IOleContainer::LockContainer Com o parâmetro fLock definido como FALSE.

Cada chamar para LockContainer Com definido como fLock TRUE deve ser balanceado por um chamar para LockContainer Com fLock definido como FALSE. Objeto aplicativos geralmente necessidade não chamar LockContainer; o manipulador usar como padrão torna essas chamadas automaticamente para aplicativos objeto implementados como .EXEs como o objeto faz a transição de e para a execução de estado. Aplicativos de objeto não usando o manipulador usar como padrão, such as DLL objeto aplicativos, devem fazer as chamadas diretamente.

Um objeto não deve ter nenhum bloqueios de alta segurança no-lo quando ele registra na tabela de objetos em execução, mas ele deve ser bloqueado assim o primeiro externo cliente se conecta a ele. Portanto, seguinte registro do objeto na Running Object Table, objeto manipuladores e aplicativos objeto DLL, como parte de sua implementação de IRunnableObject::Run, deve chamar IOleContainer::LockContainer(TRUE) para bloqueio de objeto.

Notas para Implementers

O contêiner deve controlar manter de se e como muitas chamadas para LockContainer(TRUE) foram feitas. Incremento ou diminuição de contagem de referência, IOleContainer::LockContainer Chamadas CoLockObjectExternal Com um conjunto sinalizador para corresponder ao fLock.

Requirements

Header	Oleidl.h
Windows Embedded CE	Windows CE .NET 4.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

CoLockObjectExternal
IOleContainer