ITextStoreAnchor::RequestLock 메서드(textstor.h)

TSF 관리자가 텍스트 스트림을 수정하기 위해 문서 잠금을 제공하는 데 사용됩니다.

구문

HRESULT RequestLock(
  [in]  DWORD   dwLockFlags,
  [out] HRESULT *phrSession
);

매개 변수

[in] dwLockFlags

요청된 잠금 유형을 지정합니다.

[out] phrSession

잠금 요청이 동기인 경우 는 잠금 요청의 결과를 지정하는 ITextStoreAnchorSink::OnLockGranted 메서드에서 HRESULT 값을 받습니다.

잠금 요청이 비동기이고 결과가 TS_S_ASYNC 경우 문서는 비동기 잠금을 받습니다. 잠금 요청이 비동기이고 결과가 TS_E_SYNCHRONOUS 경우 문서를 동기적으로 잠글 수 없습니다.

반환 값

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

설명

이 메서드는 ITextStoreAnchorSink::OnLockGranted 메서드를 사용하여 문서를 잠급니다. 애플리케이션은 ITextStoreAnchor::RequestLock 메서드 내에서 ITextStoreAnchorSink::OnTextChange 메서드를 사용하여 문서를 수정하거나 변경 알림을 보내서는 안 됩니다. 애플리케이션에 보고 보류 중인 변경 내용이 있는 경우 애플리케이션은 비동기 잠금 요청에만 응답할 수 있습니다.

애플리케이션에는 단일 콜백만 필요하므로 애플리케이션은 여러 ITextStoreAnchor::RequestLock 메서드 호출을 큐에 대기하려고 시도해서는 안 됩니다. 그러나 호출자가 여러 개의 읽기 요청과 하나 이상의 쓰기 요청을 만드는 경우 쓰기 액세스에 대한 콜백이어야 합니다.

동기 잠금에 대한 성공적인 요청은 비동기 잠금에 대한 요청을 대체합니다. 동기 잠금에 대한 실패한 요청은 비동기 잠금에 대한 요청을 대체하지 않습니다. 구현은 미해결 비동기 요청(있는 경우)을 계속 제공해야 합니다.

ITextStoreAnchor::RequestLock 메서드가 반환되기 전에 잠금이 부여되면 phrSession 매개 변수는 ITextStoreAnchorSink::OnLockGranted 메서드에서 반환된 HRESULT를 받습니다. 호출에 성공했지만 나중에 잠금이 부여되면 phrSession 매개 변수는 TS_S_ASYNC 플래그를 받습니다. ITextStoreAnchor::RequestLock이 S_OK 이외의 항목을 반환하는 경우 phrSession 매개 변수를 무시해야 합니다.

호출자가 읽기 전용 잠금을 보유하는 경우를 제외하고 호출자는 이 메서드를 다시 호출해서는 안 됩니다. 이 경우 메서드를 다시 호출하여 비동기 쓰기 잠금을 요청할 수 있습니다. 나중에 읽기 전용 잠금이 종료된 후 쓰기 잠금이 부여됩니다.

문서 잠금에 대한 자세한 내용은 문서 잠금을 참조하세요.

요구 사항

추가 정보

문서 잠금

ITextStoreAnchor

ITextStoreAnchorSink::OnLockGranted

TS_LF_* 상수

텍스트 저장소 반환 값