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

아티클
03/05/2024

데스크톱 항목의 추가를 확인하는 사용자 인터페이스를 표시하고, 보안 영역 권한을 확인하고, 사용자가 구독을 만들 것인지 묻는 후 활성 데스크톱에 데스크톱 항목을 추가합니다.

구문

HRESULT AddDesktopItemWithUI(
  [in, optional] HWND        hwnd,
  [in]           LPCOMPONENT pcomp,
                 DWORD       dwReserved
);

매개 변수

[in, optional] hwnd

형식: HWND

부모 창의 핸들입니다. NULL이면 해당 보안 영역 권한에 따라 사용자 인터페이스를 표시하지 않고 데스크톱 항목이 추가됩니다. 자세한 내용은 URL 보안 영역 정보를 참조하세요.

[in] pcomp

형식: LPCOMPONENT

추가할 데스크톱 항목의 세부 정보를 포함하는 COMPONENT 구조체의 주소입니다.

dwReserved

형식:DWORD

바탕 화면 항목이 추가되는 방법을 제어하는 플래그를 포함하는 부호 없는 긴 정수 값입니다. 다음 값 중 하나일 수 있습니다.

DTI_ADDUI_DEFAULT

기본 작업을 수행합니다. 0을 사용하는 것과 동일합니다.

DTI_ADDUI_DISPSUBWIZARD

사용자가 이 데스크톱 항목을 구독할 수 있도록 구독 마법사를 활성화합니다.

DTI_ADDUI_POSITIONITEM

시스템에 COMPONENT 구조체의 cpPos 멤버에 전달된 COMPPOS 구조를 확인하여 값이 적절한 한도 내에 있는지 확인하도록 지시합니다. 이 값은 인터넷 Explorer 5에 추가되었습니다.

반환 값

형식: HRESULT

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

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

설명

이 메서드는 데스크톱 항목을 추가하기 위해 활성 데스크톱의 두 번째 instance 만들어 데스크톱 항목이 현재 instance 표시되지 않도록 합니다. 애플리케이션은 이 IActiveDesktop 인터페이스에서 IUnknown::Release 메서드를 호출한 다음, CoCreateInstance 함수를 사용하여 새로 추가된 구성 요소로 Active Desktop 개체를 검색해야 합니다.

요구 사항

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

추가 정보

IActiveDesktop

활성 데스크톱 개체 사용

다음을 통해 공유