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

아티클
08/25/2023

링크 대화 상자에 표시할 수 있는 링크 에 대한 정보를 검색합니다.

구문

HRESULT GetLinkSource(
  [in]            DWORD dwLink,
  [out, optional] LPSTR *lplpszDisplayName,
  [out]           ULONG *lplenFileName,
  [out, optional] LPSTR *lplpszFullLinkType,
  [out, optional] LPSTR *lplpszShortLinkType,
  [out]           BOOL  *lpfSourceAvailable,
  [out]           BOOL  *lpfIsSelected
);

매개 변수

[in] dwLink

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

[out, optional] lplpszDisplayName

링크 원본의 전체 표시 이름 문자열에 대한 포인터를 받는 포인터 변수의 주소입니다. 링크 대화 상자에서 이 문자열을 해제합니다.

[out] lplenFileName

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

[out, optional] lplpszFullLinkType

링크 대화 상자 아래쪽에 표시되는 전체 링크 형식 문자열에 대한 포인터를 수신하는 포인터 변수의 주소입니다. 호출자가 이 문자열을 할당합니다. 링크 대화 상자에서 이 문자열을 해제합니다. OLE 링크의 경우 전체 사용자 유형 이름이어야 합니다. iOleObject::GetUserType을 사용하여 dwFormOfType에 대한 USERCLASSTYPE_FULL 지정합니다.

[out, optional] lplpszShortLinkType

링크 대화 상자의 목록 상자에 표시되는 짧은 링크 형식 문자열에 대한 포인터를 수신하는 포인터 변수의 주소입니다. 호출자가 이 문자열을 할당합니다. 링크 대화 상자에서 이 문자열을 해제합니다. OLE 링크의 경우 짧은 사용자 유형 이름이어야 합니다. iOleObject::GetUserType을 사용하여 dwFormOfType에 대한 USERCLASSTYPE_SHORT 지정합니다.

[out] lpfSourceAvailable

링크가 알려져 있지만 사용할 수 없는 문서에 연결되므로 링크를 사용할 수 없는 것으로 알려진 경우 FALSE 를 반환하는 포인터입니다. 이러한 경우 지금 업데이트와 같은 특정 옵션은 사용하지 않도록 설정됩니다(사용자 인터페이스에서 회색으로 표시됨).

[out] lpfIsSelected

대화 상자의 다중 선택 목록 상자에서 이 링크의 항목을 선택해야 함을 링크 편집 대화 상자에 알려주는 변수에 대한 포인터입니다. OleUIEditLinks는 링크 목록에 배치할 각 항목에 대해 이 메서드를 한 번 이상 호출합니다. TRUE를 반환하지 않으면 대화 상자가 처음 표시될 때 선택되지 않습니다. 모두 TRUE를 반환하면 모두 표시됩니다. 즉, 이 링크가 현재 기본 문서에서 선택 영역의 일부인 경우 TRUE 를 반환하고, 그렇지 않으면 FALSE 를 반환합니다. 기본 문서에서 선택한 링크는 대화 상자에서 선택됩니다. 이렇게 하면 사용자는 링크 집합을 선택하고 대화 상자를 사용하여 링크를 업데이트하거나 원본을 동시에 변경할 수 있습니다.

반환 값

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

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

설명

발신자에 대한 참고 사항

원본 변경 대화 상자에서 반환한 후 대화 상자를 초기화하는 동안 이 메서드를 호출합니다.

요구 사항

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