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

링크의 원본을 변경합니다.

구문

HRESULT SetLinkSource(
  [in]  DWORD dwLink,
  [in]  LPSTR lpszDisplayName,
  [in]  ULONG lenFileName,
  [out] ULONG *pchEaten,
  [in]  BOOL  fValidateSource
);

매개 변수

[in] dwLink

단일 링크에 대한 컨테이너 정의 고유 식별자입니다. IOleUILinkContainer::GetNextLink를 참조하세요.

[in] lpszDisplayName

구문 분석할 새 소스 문자열에 대한 포인터입니다.

[in] lenFileName

lpszDisplayName 문자열의 선행 파일 이름 부분 길이입니다. 링크 원본이 파일에 저장되지 않은 경우 lenFileName 은 0이어야 합니다. OLE 링크의 경우 IOleLink::GetSourceDisplayName을 호출합니다.

[out] pchEaten

lpszDisplayName에서 성공적으로 구문 분석된 문자 수에 대한 포인터입니다.

[in] fValidateSource

모 니커의 유효성을 검사해야 하는 경우 TRUE입니다. OLE 링크의 경우 MkParseDisplayName 을 호출해야 합니다. 모니커의 유효성을 검사하지 않아야 하는 경우 FALSE입니다. 가능한 경우 링크는 유효성이 검사되지 않은 원본을 수락하고 자신을 사용할 수 없음으로 표시해야 합니다.

반환 값

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

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

설명

발신자에게 참고 사항

fValidateSource가 처음에 TRUE로 설정된 상태에서 원본 변경 대화 상자에서 이 메서드를 호출합니다. 변경 원본 은 직접 호출하거나 링크 대화 상자에서 호출할 수 있습니다. IOleUILinkContainer::SetLinkSource에 대한 이 호출이 오류를 반환하는 경우(예: 원본을 사용할 수 없어 MkParseDisplayName이 실패함) 잘못된 링크 원본 메시지를 표시해야 하며 사용자가 원본을 수정할지 여부를 결정할 수 있어야 합니다. 사용자가 원본을 수정하도록 선택하면 입력 문자열의 잘못된 부분이 강조 표시된 원본 변경 대화 상자로 사용자에게 반환되어야 합니다. 사용자가 원본을 수정하지 않기로 선택한 경우 fValidateSource가 FALSE로 설정된 상태에서 IOleUILinkContainer::SetLinkSource를 두 번째로 호출해야 하며, 링크가 사용할 수 없음으로 표시된 링크 대화 상자로 사용자에게 반환되어야 합니다.

요구 사항

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

추가 정보

IOleUILinkContainer

MkParseDisplayName