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

아티클
03/05/2024

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

구문

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