Método ITextStoreAnchorSink::OnLockGranted (textstor.h)

Chamado para conceder um bloqueio de documento.

Sintaxe

HRESULT OnLockGranted(
  [in] DWORD dwLockFlags
);

Parâmetros

[in] dwLockFlags

Contém um conjunto de sinalizadores que identificam o tipo de bloqueio solicitado e outros dados de solicitação de bloqueio. Esse pode ser um dos valores a seguir.

Valor	Significado
TS_LF_READ	O bloqueio é somente leitura.
TS_LF_READWRITE	O bloqueio é de leitura/gravação.

Retornar valor

Esse método pode retornar um desses valores.

Valor	Descrição
S_OK	O método foi bem-sucedido.
E_INVALIDARG	dwLockFlags é inválido.
E_UNEXPECTED	O tipo errado de bloqueio foi concedido.

Comentários

Um bloqueio de documento é solicitado chamando ITextStoreAnchor::RequestLock. O aplicativo concede a solicitação de bloqueio chamando ITextStoreAnchorSink::OnLockGranted com o tipo de bloqueio solicitado. O bloqueio só é válido durante a chamada OnLockGranted . Quando OnLockGranted retorna, o documento é considerado desbloqueado.

O tipo de bloqueio, especificado em dwLockFlags, deve corresponder ao tipo de bloqueio solicitado na chamada correspondente a ITextStoreAnchor::RequestLock.

Chamadas para ITextStoreAnchor::RequestLock de dentro de OnLockGranted retornarão um valor de erro.

Os aplicativos não devem chamar nenhum dos métodos ITextStoreAnchorSink de dentro do contexto de OnLockGranted.

Se uma solicitação de bloqueio síncrona for feita de dentro de ITextStoreAnchor::RequestLock, o chamador também deverá fornecer o valor retornado de ITextStoreAnchor::RequestLock.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 2000 Professional [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte	Windows 2000 Server [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino	Windows
Cabeçalho	textstor.h
DLL	Msctf.dll
Redistribuível	TSF 1.0 no Windows 2000 Professional

Confira também

Bloqueios de documento

ITextStoreAnchor::RequestLock

ITextStoreAnchorSink

Constantes TS_LF_*