IOleUILinkContainerA::UpdateLink 메서드(oledlg.h)

아티클
03/01/2024

선택한 링크를 강제로 원본에 연결하고 현재 정보를 검색합니다.

구문

HRESULT UpdateLink(
  [in] DWORD dwLink,
  [in] BOOL  fErrorMessage,
  [in] BOOL  fReserved
);

매개 변수

[in] dwLink

단일 링크에 대한 컨테이너 정의 고유 식별자입니다. 컨테이너는 이 값에 대해 링크의 컨테이너 사이트에 대한 포인터를 사용할 수 있습니다.

[in] fErrorMessage

링크를 업데이트하지 못한 경우 호출자( IOleUILinkContainer의 구현자)가 오류 메시지를 표시할지 여부를 결정합니다. 링크 업데이트 대화 상자는 이를 FALSE로 설정합니다. 개체 속성 및 링크 대화 상자는 TRUE로 설정합니다.

[in] fReserved

이 매개 변수는 예약되어 있으며 FALSE로 설정해야 합니다.

반환 값

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

반환 코드	Description
E_ACCESSDENIED	액세스 권한이 부족합니다.
E_FAIL	작업이 실패했습니다.
E_INVALIDARG	지정된 식별자가 잘못되었습니다.
E_OUTOFMEMORY	이 작업에 사용할 수 있는 메모리가 부족합니다.

설명

발신자에게 참고 사항

fErrorMessage가 TRUE로 설정된 상태에서 이 메서드를 호출합니다. 사용자가 명시적으로 단추를 눌러 링크를 업데이트하는 경우, 즉 링크의 지금 업데이트 단추를 누릅니다. 컨테이너가 오류 메시지를 표시해서는 안 되는 경우, 즉 대규모 작업 집합이 수행되고 업데이트 링크 진행률 측정기에서 발생할 수 있는 것처럼 나중에 사용자에게 오류를 다시 전파해야 하는 경우 FALSE로 호출합니다. 실패가 있다고 가정할 때 각 실패에 대해 하나의 메시지를 제공하는 대신 작업이 끝날 때 모든 실패에 대해 단일 메시지를 제공합니다.

구현자에 대한 참고 사항

OLE 링크의 경우 IOleObject::Update를 호출합니다.

요구 사항

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

추가 정보

IOleObject::Update

IOleUILinkContainer

다음을 통해 공유