다음을 통해 공유


IOleLink::SetUpdateOptions 메서드(oleidl.h)

연결된 개체가 캐시된 데이터를 업데이트하는 빈도를 지정합니다.

구문

HRESULT SetUpdateOptions(
  [in] DWORD dwUpdateOpt
);

매개 변수

[in] dwUpdateOpt

연결된 개체가 캐시된 데이터를 업데이트하는 빈도를 지정합니다. dwUpdateOpt에 대한 가능한 값은 OLEUPDATE 열거형에서 가져옵니다.

반환 값

이 메서드는 성공에 대한 S_OK 반환합니다. 가능한 다른 반환 값은 다음과 같습니다.

반환 코드 설명
E_INVALIDARG
제공된 값이 잘못되었습니다.

설명

발신자에 대한 참고 사항

컨테이너 애플리케이션은 최종 사용자가 연결된 개체에 대한 업데이트 옵션을 변경할 때 IOleLink::SetUpdateOptions 를 호출해야 합니다.

최종 사용자는 링크 대화 상자를 사용하여 연결된 개체에 대한 업데이트 옵션을 선택합니다. OleUIEditLinks 함수를 사용하여 이 대화 상자를 표시하는 경우 IOleUILinkContainer 인터페이스를 구현해야 합니다. 대화 상자는 IOleUILinkContainer::SetLinkUpdateOptions 메서드를 호출하여 최종 사용자가 선택한 업데이트 옵션을 지정합니다. 이 메서드의 구현에서는 IOleLink::SetUpdateOptions 메서드를 호출하여 선택한 옵션을 연결된 개체에 전달해야 합니다.

구현자에 대한 참고 사항

기본 업데이트 옵션은 OLEUDPATE_ALWAYS. 연결된 개체의 IPersistStorage::Save 구현은 현재 업데이트 옵션을 저장합니다.

OLEUDPATE_ALWAYS 업데이트 옵션으로 지정된 경우 연결된 개체는 다음과 같은 상황에서 링크의 캐시를 업데이트합니다.

  • 업데이트 옵션이 수동에서 자동으로 변경되면 링크 원본이 실행 중인 경우 입니다.
  • 연결된 개체가 링크 원본에 바인딩할 때마다
  • 링크 원본이 실행되고 연결된 개체의 IOleObject::Close, IPersistStorage::Save 또는 IAdviseSink::OnSave 구현이 호출됩니다.
수동 및 자동 링크 모두에 대해 연결된 개체는 컨테이너 애플리케이션 이 IOleObject::Update 또는 IOleLink::Update를 호출할 때마다 캐시를 업데이트합니다.

요구 사항

요구 사항
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 oleidl.h

추가 정보

IOleLink

IOleLink::GetUpdateOptions

IOleLink::Update

IOleObject::Update

IOleUILinkContainer

OleUIEditLinks