다음을 통해 공유

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

  • 아티클

지정된 ID와 일치하는 데스크톱 항목을 가져옵니다.

구문

HRESULT GetDesktopItemByID(
            ULONG_PTR   dwID,
  [in, out] LPCOMPONENT pcomp,
            DWORD       dwReserved
);

매개 변수

dwID

형식: ULONG_PTR

바탕 화면 항목의 ID를 포함하는 부호 없는 긴 정수 값입니다.

[in, out] pcomp

형식: LPCOMPONENT

검색된 데스크톱 항목의 COMPONENT 구조체 주소입니다.

dwReserved

형식:DWORD

예약되어 있습니다. 0으로 설정해야 합니다.

반환 값

형식: HRESULT

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

데스크톱 항목의 ID는 IActiveDesktop::GetDesktopItem 메서드에서 반환되는 COMPONENT 구조의 dwID 멤버에 반환됩니다. 이 ID는 IActiveDesktop::ApplyChanges 메서드가 호출될 때까지만 유효합니다. 동일한 데스크톱 항목을 일관되게 검색해야 하는 애플리케이션은 IActiveDesktop::GetDesktopItem 및 IActiveDesktop::GetDesktopItemCount 메서드를 사용하여 데스크톱 항목을 열거해야 합니다.

요구 사항

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

추가 정보

IActiveDesktop