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 |