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

아티클
03/05/2024

연결된 개체에 대해 복합 문서의 캐시된 데이터를 업데이트. 아직 바인딩되지 않은 경우 링크 원본에 대한 바인딩이 포함됩니다.

구문

HRESULT Update(
  [in] IBindCtx *pbc
);

매개 변수

[in] pbc

링크 원본을 바인딩하는 데 사용할 바인딩 컨텍스트의 IBindCtx 인터페이스에 대한 포인터입니다. 이 매개 변수는 NULL일 수 있습니다. 바인딩 컨텍스트는 바인딩 프로세스 중에 바인딩된 개체를 캐시하고, 바인딩 컨텍스트를 사용하여 모든 작업에 적용되는 매개 변수를 포함하며, 바인딩 구현이 해당 환경에 대한 정보를 검색해야 하는 수단을 제공합니다. 자세한 내용은 IBindCtx를 참조하세요.

반환 값

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

반환 코드	설명
CACHE_E_NOCACHE_UPDATE	바인딩 작업이 작동했지만 캐시가 업데이트되지 않았습니다.
CACHE_S_SOMECACHES_NOTUPDATED	바인딩 작업이 작동했지만 모든 캐시가 업데이트되지는 않았습니다.
OLE_E_CANT_BINDTOSOURCE	링크 원본에 바인딩할 수 없습니다.

설명

발신자에게 참고 사항

최종 사용자가 연결된 개체에 대해 캐시된 데이터를 업데이트하는 경우 컨테이너 애플리케이션에서 Update 를 호출해야 합니다.

최종 사용자는 링크 대화 상자에서 지금 업데이트 단추를 선택하여 연결된 개체에 대해 캐시된 데이터를 업데이트할 수 있습니다. OleUIEditLinks 함수를 사용하여 링크 대화 상자를 표시하는 경우 IOleUILinkContainer 인터페이스를 구현해야 합니다. 대화 상자는 최종 사용자가 지금 업데이트 단추를 선택하면 IOleUILinkContainer::UpdateLink의 구현을 호출합니다. 해당 메서드의 구현은 Update를 호출할 수 있습니다.

컨테이너 애플리케이션은 연결된 개체에서 호출 할 때 Update를 호출하므로 연결된 개체를 업데이트하기 위해 Update 를 호출할 수도 있습니다.

이 메서드는 자동 링크와 수동 링크를 모두 업데이트합니다. 수동 링크의 경우 업데이트 또는 업데이트를 호출하는 것이 캐시를 업데이트하는 유일한 방법입니다. 자동 및 수동 링크에 대한 자세한 내용은 IOleLink::SetUpdateOptions를 참조하세요.

구현에 대한 참고 사항

pbc가 NULL이 아닌 경우 연결된 개체의 Update 구현은 IBindCtx::RegisterObjectBound를 호출하여 바인딩된 링크 원본을 등록합니다. 이렇게 하면 바인딩 컨텍스트가 해제될 때까지 링크 원본이 계속 실행됩니다.

링크 원본을 바인딩할 수 없는 경우 현재 캐시는 그대로 유지됩니다.

요구 사항

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