IOleCacheControl::OnRun 메서드(oleidl.h)
캐시 개체가 필요에 따라 조언 싱크를 설정할 수 있도록 데이터 원본 개체가 실행 중 상태로 들어갔다는 것을 캐시에 알 보냅니다.
구문
HRESULT OnRun(
[in] LPDATAOBJECT pDataObject
);
매개 변수
[in] pDataObject
실행 상태를 입력하는 개체의 IDataObject 인터페이스에 대한 포인터입니다.
반환 값
이 메서드는 성공에 대한 S_OK 반환합니다. 가능한 다른 반환 값은 다음과 같습니다.
| 반환 코드 | 설명 |
|---|---|
|
인수 중 하나가 잘못되었습니다. |
|
예기치 않은 오류가 발생했습니다. |
|
이 작업에 사용할 수 있는 메모리가 부족합니다. |
설명
OnRun이 호출되면 캐시는 알림을 받을 수 있도록 원본 데이터 개체와 필요에 따라 권고 연결을 설정합니다. 실행 중인 개체와 캐시 간에 생성된 권고 연결은 IOleCacheControl::OnStop 이 호출되면 제거됩니다.
일부 개체 처리기 또는 In-Process 서버는 캐시를 수동적으로 사용하고 OnRun을 호출하지 않을 수 있습니다. 이러한 애플리케이션은 필요한 경우 캐시가 업데이트되도록 하려면 IOleCache2::UpdateCache, IOleCache::InitCache 또는 IOleCache::SetData 를 호출하여 캐시를 채워야 합니다.
OnRun은 pDataObject에 전달된 IDataObject에 대한 포인터에 대한 참조 수를 추가하지 않습니다. OnStop이 호출될 때까지 pDataObject 포인터의 수명이 지속되는지 확인하는 것은 OleRun 호출자의 책임이므로 호출자는 관심 있는 데이터 개체에 대한 IDataObject에 대한 포인터를 보유해야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional[데스크톱 앱만] |
| 지원되는 최소 서버 | Windows 2000 Server[데스크톱 앱만] |
| 대상 플랫폼 | Windows |
| 헤더 | oleidl.h |