IStream::UnlockRegion 메서드(objidl.h)

UnlockRegion 메서드는 이전에 IStream::LockRegion으로 제한되었던 바이트 범위에 대한 액세스 제한을 제거합니다.

구문

HRESULT UnlockRegion(
  [in] ULARGE_INTEGER libOffset,
  [in] ULARGE_INTEGER cb,
  [in] DWORD          dwLockType
);

매개 변수

[in] libOffset

범위의 시작 부분에 대한 바이트 오프셋을 지정합니다.

[in] cb

제한할 범위의 길이를 바이트 단위로 지정합니다.

[in] dwLockType

이전에 범위에 배치된 액세스 제한을 지정합니다.

반환 값

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

반환 코드	설명
S_OK	바이트 범위가 잠금 해제되었습니다.
E_PENDING	비동기 스토리지만 해당: 스트림 데이터의 일부 또는 전체를 현재 사용할 수 없습니다.
STG_E_INVALIDFUNCTION	잠금은 전혀 지원되지 않거나 요청된 특정 유형의 잠금이 지원되지 않습니다.
STG_E_LOCKVIOLATION	요청된 잠금 해제 작업을 부여할 수 없습니다.
STG_E_REVERTED	개체가 트랜잭션 트리에서 위의 되돌리기 작업에 의해 무효화되었습니다.

설명

IStream::UnlockRegion 은 이전에 IStream::LockRegion 메서드를 사용하여 잠긴 지역을 잠금 해제합니다. 나중에 libOffset, cb 및 dwLockType 매개 변수에 대해 정확히 동일한 값으로 IStream::UnlockRegion을 호출하여 잠긴 지역을 명시적으로 잠금 해제해야 합니다. 스트림이 해제되기 전에 영역의 잠금을 해제해야 합니다. 인접한 두 지역은 별도로 잠근 다음 단일 잠금 해제 호출로 잠금 해제할 수 없습니다.

요구 사항

지원되는 최소 클라이언트	Windows 2000 Professional [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows 2000 Server [데스크톱 앱 | UWP 앱]
대상 플랫폼	Windows
헤더	objidl.h
라이브러리	Uuid.lib
DLL	Ole32.dll

추가 정보

IStream - 복합 파일 구현

IStream::LockRegion

LOCKTYPE