다음을 통해 공유

IActiveDesktop::AddUrl 메서드(shlobj_core.h)

  • 아티클

지정된 URL과 연결된 데스크톱 항목을 추가합니다.

구문

HRESULT AddUrl(
  [in, optional] HWND        hwnd,
  [in]           PCWSTR      pszSource,
  [in]           LPCOMPONENT pcomp,
                 DWORD       dwFlags
);

매개 변수

[in, optional] hwnd

형식: HWND

사용자 인터페이스의 부모 창에 대한 핸들입니다.

[in] pszSource

형식: PCWSTR

데스크톱 항목의 URL을 포함하는 문자열에 대한 포인터입니다.

[in] pcomp

형식: LPCOMPONENT

추가할 데스크톱 항목의 세부 정보가 포함된 COMPONENT 구조체에 대한 포인터입니다.

dwFlags

형식:DWORD

이 메서드를 제어하는 부호 없는 긴 정수 값입니다. 사용자 인터페이스를 표시하지 않고 데스크톱 항목을 추가하려면 ADDURL_SILENT 설정할 수 있습니다.

반환 값

형식: HRESULT

다음 값 중 하나를 반환합니다.

반환 코드 설명
E_FAIL
 데스크톱 항목을 추가하지 못했거나 데스크톱 항목의 instance 이미 활성 데스크톱에 있습니다.
E_INVAILDARG
 하나 이상의 매개 변수가 잘못되었습니다.
S_OK
 ADDURL_SILENT 플래그가 설정된 경우 데스크톱 항목이 성공적으로 추가되었거나 활성 데스크톱에 이미 있습니다. 그렇지 않으면 데스크톱 항목이 성공적으로 추가되었습니다.

설명

기본적으로 이 메서드는 일부 사용자 인터페이스를 표시한 다음, 데스크톱 항목을 활성 데스크톱에 추가합니다. IActiveDesktop::AddDesktopItem과 마찬가지로 클라이언트 애플리케이션은 IActiveDesktop::ApplyChanges를 호출하여 변경 내용을 레지스트리에 저장해야 합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 2000 Professional, Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 shlobj_core.h
DLL Shell32.dll(버전 4.71 이상)

추가 정보

IActiveDesktop

활성 데스크톱 개체 사용