Metodo ITextStoreAnchorSink::OnLockGranted (textstor.h)

Chiamata chiamata per concedere un blocco di documento.

Sintassi

HRESULT OnLockGranted(
  [in] DWORD dwLockFlags
);

Parametri

[in] dwLockFlags

Contiene un set di flag che identificano il tipo di blocco richiesto e altri dati della richiesta di blocco. Può trattarsi di uno dei valori seguenti.

Valore	Significato
TS_LF_READ	Il blocco è di sola lettura.
TS_LF_READWRITE	Il blocco è di lettura/scrittura.

Valore restituito

Questo metodo può restituire uno di questi valori.

Valore	Descrizione
S_OK	Il metodo è stato eseguito correttamente.
E_INVALIDARG	dwLockFlags non è valido.
E_UNEXPECTED	È stato concesso il tipo di blocco errato.

Commenti

Viene richiesto un blocco di documenti chiamando ITextStoreAnchor::RequestLock. L'applicazione concede la richiesta di blocco chiamando ITextStoreAnchorSink::OnLockGranted con il tipo di blocco richiesto. Il blocco è valido solo durante la chiamata OnLockGranted . Quando OnLockGranted viene restituito , il documento viene considerato sbloccato.

Il tipo di blocco, specificato in dwLockFlags, deve corrispondere al tipo di blocco richiesto nella chiamata corrispondente a ITextStoreAnchor::RequestLock.

Le chiamate a ITextStoreAnchor::RequestLock dall'interno di OnLockGranted restituiranno un valore di errore.

Le applicazioni non devono chiamare alcun metodo ITextStoreAnchorSink dal contesto di OnLockGranted.

Se viene effettuata una richiesta di blocco sincrona da ITextStoreAnchor::RequestLock, il chiamante deve specificare anche il valore restituito da ITextStoreAnchor::RequestLock.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [app desktop | App UWP]
Server minimo supportato	Windows 2000 Server [app desktop | App UWP]
Piattaforma di destinazione	Windows
Intestazione	textstor.h
DLL	Msctf.dll
Componente ridistribuibile	TSF 1.0 in Windows 2000 Professional

Vedi anche

Blocchi documento

ITextStoreAnchor::RequestLock

ITextStoreAnchorSink

Costanti TS_LF_*