IShellExtInit::Initialize 메서드(shobjidl_core.h)

속성 시트 확장, 바로 가기 메뉴 확장 또는 끌어서 놓기 처리기를 초기화합니다.

구문

HRESULT Initialize(
  [in] PCIDLIST_ABSOLUTE pidlFolder,
  [in] IDataObject       *pdtobj,
  [in] HKEY              hkeyProgID
);

매개 변수

[in] pidlFolder

형식: PCIDLIST_ABSOLUTE

폴더를 고유하게 식별하는 ITEMIDLIST 구조체에 대한 포인터입니다. 속성 시트 확장의 경우 이 매개 변수는 NULL입니다. 바로 가기 메뉴 확장의 경우 바로 가기 메뉴가 표시되는 항목이 포함된 폴더의 항목 식별자 목록입니다. 기본값이 아닌 끌어서 놓기 메뉴 확장의 경우 이 매개 변수는 대상 폴더를 지정합니다.

[in] pdtobj

형식: IDataObject*

동작하는 개체를 검색하는 데 사용할 수 있는 IDataObject 인터페이스 개체에 대한 포인터입니다.

[in] hkeyProgID

형식: HKEY

파일 개체 또는 폴더 형식에 대한 레지스트리 키입니다.

반환 값

형식: HRESULT

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

설명

일부 매개 변수의 의미는 확장 형식에 따라 달라집니다. 끌어서 놓기 처리기의 경우 pidlFolder 매개 변수는 대상 폴더(놓기 대상)를 지정하고 , pdtobj 매개 변수는 삭제되는 항목을 식별하고, hkeyProgID 매개 변수는 대상 폴더의 파일 형식을 지정합니다.

바로 가기 메뉴 확장 프로그램의 경우 pdtobj는 선택한 파일 개체를 식별하고, hkeyProgID는 포커스가 있는 개체의 파일 형식을 식별하며, pidlFolderNULL(파일 개체의 경우)이거나 바로 가기 메뉴가 요청되는 폴더(폴더 배경 바로 가기 메뉴의 경우)를 지정합니다.

속성 시트 확장의 경우 pidlFolderNULL이고 , pdtobj 는 선택한 파일 개체를 식별하고, hkeyProgID 는 포커스가 있는 파일 개체의 파일 형식을 지정합니다.

구현자에 대한 참고 사항

셸이 속성 시트 확장, 바로 가기 메뉴 확장 또는 끌어서 놓기 처리기의 인스턴스를 만든 후 호출하는 첫 번째 메서드입니다.

요구 사항

   
지원되는 최소 클라이언트 Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 shobjidl_core.h(Shobjidl.h 포함)
DLL Shell32.dll(버전 4.0 이상)