셸 확장 처리기 만들기

셸의 기능은 레지스트리 항목 및 .ini 파일로 확장할 수 있습니다. 셸을 확장하는 이 방법은 간단하고 다양한 용도로 적합하지만 제한적입니다. 예를 들어 레지스트리를 사용하여 파일 형식에 대한 사용자 지정 아이콘을 지정하는 경우 해당 형식의 모든 파일에 대해 동일한 아이콘이 표시됩니다. 레지스트리를 사용하여 셸을 확장해도 동일한 형식의 다른 파일에 대한 아이콘을 변경할 수 없습니다. 파일을 마우스 오른쪽 단추로 클릭할 때 표시할 수 있는 속성 속성 시트와 같은 Shell의 다른 측면은 레지스트리를 사용하여 전혀 수정할 수 없습니다.

Shell을 확장하는 보다 강력하고 유연한 접근 방식은 셸 확장 처리기를 구현하는 것입니다. 이러한 처리기는 셸에서 수행할 수 있는 다양한 작업에 대해 구현할 수 있습니다. 작업을 수행하기 전에 Shell은 확장 처리기를 쿼리하여 작업을 수정할 수 있는 기회를 제공합니다. 일반적인 예는 바로 가기 메뉴 확장 처리기입니다. 파일 형식에 대해 구현되는 경우 파일 중 하나를 마우스 오른쪽 단추로 클릭할 때마다 쿼리됩니다. 그런 다음 처리기는 전체 파일 형식에 대해 동일한 집합을 갖지 않고 파일별로 추가 메뉴 항목을 지정할 수 있습니다.

이 문서에서는 다양한 셸 작업을 수정할 수 있는 확장 처리기를 구현하는 방법을 설명합니다. 다음 처리기는 특정 파일 형식과 연결되며 파일 단위로 지정할 수 있습니다.

Handler Description
바로 가기 메뉴 처리기 파일의 바로 가기 메뉴가 표시되기 전에 호출됩니다. 파일 단위로 바로 가기 메뉴에 항목을 추가할 수 있습니다.
데이터 처리기 dragShell 개체에서 끌어서 놓기 작업을 수행할 때 호출됩니다. 드롭 대상에 추가 클립보드 형식을 제공할 수 있습니다.
드롭 처리기 데이터 개체를 끌어서 놓을 때 호출됩니다. 파일을 놓기 대상으로 만들 수 있습니다.
아이콘 처리기 파일의 아이콘이 표시되기 전에 호출됩니다. 파일 단위로 파일의 기본 아이콘을 사용자 지정 아이콘으로 바꿀 수 있습니다.
속성 시트 처리기 개체의 속성 속성 시트가 표시되기 전에 호출됩니다. 페이지를 추가하거나 바꿀 수 있습니다.
썸네일 이미지 처리기 항목을 나타내는 이미지를 제공합니다.
정보 팁 처리기 사용자가 개체 위에 마우스 포인터를 놓을 때 팝업 텍스트를 제공합니다.
메타데이터 처리기 파일에 저장된 메타데이터(속성)에 대한 읽기 및 쓰기 액세스를 제공합니다. 세부 정보 보기, 정보 설명, 속성 페이지 및 그룹화 기능을 확장하는 데 사용할 수 있습니다.

 

다른 처리기는 특정 파일 형식과 연결되지 않지만 일부 셸 작업 전에 호출됩니다.

Handler Description
열 처리기 폴더의 세부 정보 보기가 표시되기 전에 Windows Explorer 호출됩니다. 세부 정보 보기에 사용자 지정 열을 추가할 수 있습니다.
후크 처리기 복사 폴더 또는 프린터 개체를 이동, 복사, 삭제 또는 이름을 바꾸려면 호출됩니다. 작업을 승인하거나 거부할 수 있습니다.
끌어서 놓기 처리기 마우스 오른쪽 단추로 파일을 끌 때 호출됩니다. 그러면 표시되는 바로 가기 메뉴를 수정할 수 있습니다.
아이콘 오버레이 처리기 파일의 아이콘이 표시되기 전에 호출됩니다. 파일 아이콘에 대한 오버레이를 지정할 수 있습니다.
검색 처리기 검색 엔진을 시작하기 위해 호출됩니다. 시작 메뉴 또는 Windows Explorer 액세스할 수 있는 사용자 지정 검색 엔진을 구현할 수 있습니다.

 

특정 확장 처리기를 구현하는 방법에 대한 세부 정보는 위에 나열된 섹션에서 다룹니다. 이 문서의 나머지 부분에서는 모든 Shell 확장 처리기에 공통적인 몇 가지 구현 문제를 다룹니다.

셸 확장 처리기 구현

Shell 확장 처리기 개체 구현의 대부분은 해당 형식에 따라 달라집니다. 그러나 몇 가지 일반적인 요소가 있습니다. 이 섹션에서는 모든 Shell 확장 처리기에서 공유하는 구현의 이러한 측면에 대해 설명합니다.

많은 Shell 확장 처리기는 COM(In-process Component Object Model) 개체입니다. GUID를 할당하고 셸 확장 처리기 등록에 설명된 대로 등록해야 합니다. DLL로 구현되며 다음 표준 함수를 내보내야 합니다.

  • DllMain. DLL에 대한 표준 진입점입니다.
  • DllGetClassObject. 개체의 클래스 팩터리를 노출합니다.
  • DllCanUnloadNow. COM은 이 함수를 호출하여 개체가 클라이언트에 서비스를 제공하는지 여부를 확인합니다. 그렇지 않은 경우 시스템에서 DLL을 언로드하고 연결된 메모리를 해제할 수 있습니다.

모든 COM 개체와 마찬가지로 셸 확장 처리기는 IUnknown 인터페이스 및 클래스 팩터리를 구현해야 합니다. 또한 대부분의 확장 처리기는 Windows XP 또는 이전 버전에서 IPersistFile 또는 IShellExtInit 인터페이스를 구현해야 합니다. 이러한 항목은 Windows Vista의 IInitializeWithStream, IInitializeWithItemIInitializeWithFile 로 대체되었습니다. 셸은 이러한 인터페이스를 사용하여 처리기를 초기화합니다.

IPersistFile 인터페이스는 다음을 통해 구현해야 합니다.

  • 데이터 처리기
  • 드롭 처리기

이전에는 IPersistFile을 구현하기 위해 아이콘 처리기도 필요했지만 더 이상 그렇지 않습니다. 아이콘 처리기의 경우 이제 IPersistFile 이 선택 사항이며 IInitializeWithItem 과 같은 다른 인터페이스가 선호됩니다.

IShellExtInit 인터페이스는 다음을 통해 구현해야 합니다.

  • 바로 가기 메뉴 처리기
  • 끌어서 놓기 처리기
  • 속성 시트 처리기

IPersistFile 구현

IPersistFile 인터페이스는 개체를 디스크 파일에서 로드하거나 디스크 파일에 저장할 수 있도록 하기 위한 것입니다. IUnknown 외에도 6개의 메서드, 5개의 자체 메서드 및 IPersist에서 상속하는 GetClassID 메서드가 있습니다. 셸 확장을 사용하면 IPersist 는 셸 확장 처리기 개체를 초기화하는 데만 사용됩니다. 일반적으로 디스크에서 읽거나 디스크에 쓸 필요가 없으므로 GetClassIDLoad 메서드만 토큰이 아닌 구현이 필요합니다.

Shell은 먼저 GetClassID 를 호출하고 함수는 확장 처리기 개체의 CLSID(클래스 식별자)를 반환합니다. 그런 다음 셸은 Load 를 호출하고 두 값을 전달합니다. 첫 번째 pszFileName은 Shell이 작동할 파일 또는 폴더의 이름을 가진 유니코드 문자열입니다. 두 번째는 파일 액세스 모드를 나타내는 dwMode입니다. 일반적으로 파일에 액세스할 필요가 없으므로 dwMode 는 일반적으로 0입니다. 메서드는 나중에 참조하기 위해 필요에 따라 이러한 값을 저장합니다.

다음 코드 조각에서는 일반적인 Shell 확장 처리기가 GetClassIDLoad 메서드를 구현하는 방법을 보여 줍니다. ANSI 또는 유니코드를 처리하도록 설계되었습니다. CLSID_SampleExtHandler 확장 처리기 개체의 GUID이고 CSampleExtHandler는 인터페이스를 구현하는 데 사용되는 클래스의 이름입니다. m_szFileNamem_dwMode 변수는 파일의 이름 및 액세스 플래그를 저장하는 데 사용되는 프라이빗 변수입니다.

wchar_t m_szFileName[MAX_PATH];    // The file name
DWORD m_dwMode;                  // The file access mode

CSampleExtHandler::GetClassID(CLSID *pCLSID)
{
    *pCLSID = CLSID_SampleExtHandler;
}

CSampleExtHandler::Load(PCWSTR pszFile, DWORD dwMode)
{
    m_dwMode = dwMode;
    return StringCchCopy(_szFileName, ARRAYSIZE(m_szFileName), pszFile);
}

IShellExtInit 구현

IShellExtInit 인터페이스에는 IUnknown 외에 IShellExtInit::Initialize라는 하나의 메서드만 있습니다. 메서드에는 Shell이 다양한 유형의 정보를 전달하는 데 사용할 수 있는 세 가지 매개 변수가 있습니다. 전달되는 값은 처리기 유형에 따라 달라지고 일부는 NULL로 설정할 수 있습니다.

  • pIDFolder 는 PIDL(항목 식별자 목록)에 대한 폴더의 포인터를 보유합니다. 속성 시트 확장의 경우 NULL입니다. 바로 가기 메뉴 확장의 경우 바로 가기 메뉴가 표시되는 항목이 포함된 폴더의 PIDL입니다. 기본이 아닌 끌어서 놓기 처리기의 경우 대상 폴더의 PIDL입니다.
  • pDataObject 는 데이터 개체의 IDataObject 인터페이스에 대한 포인터를 보유합니다. 데이터 개체는 CF_HDROP 형식으로 하나 이상의 파일 이름을 보유합니다.
  • hRegKey 는 파일 개체 또는 폴더 형식에 대한 레지스트리 키를 보유합니다.

IShellExtInit::Initialize 메서드는 나중에 사용하기 위해 필요에 따라 파일 이름, IDataObject 포인터 및 레지스트리 키를 저장합니다. 다음 코드 조각에서는 IShellExtInit::Initialize의 구현을 보여 줍니다. 간단히 하기 위해 이 예제에서는 데이터 개체에 단일 파일만 포함되어 있다고 가정합니다. 일반적으로 각각 추출해야 하는 여러 파일이 포함될 수 있습니다.

LPCITEMIDLIST  m_pIDFolder;           //The folder's PIDL
wchar_t        m_szFile[MAX_PATH];    //The file name
IDataObject   *m_pDataObj;            //The IDataObject pointer
HKEY           m_hRegKey;             //The file or folder's registry key

STDMETHODIMP CShellExt::Initialize(LPCITEMIDLIST pIDFolder, 
                                   IDataObject *pDataObj, 
                                   HKEY hRegKey) 
{ 
    // If Initialize has already been called, release the old PIDL
    ILFree(m_pIDFolder);
    m_pIDFolder = nullptr;

    // Store the new PIDL.
    if (pIDFolder)
    {
        m_pIDFolder = ILClone(pIDFolder);
    }
    
    // If Initialize has already been called, release the old
    // IDataObject pointer.
    if (m_pDataObj)
    { 
        m_pDataObj->Release(); 
    }
     
    // If a data object pointer was passed in, save it and
    // extract the file name. 
    if (pDataObj) 
    { 
        m_pDataObj = pDataObj; 
        pDataObj->AddRef(); 
      
        STGMEDIUM   medium;
        FORMATETC   fe = {CF_HDROP, NULL, DVASPECT_CONTENT, -1, TYMED_HGLOBAL};
        UINT        uCount;

        if (SUCCEEDED(m_pDataObj->GetData(&fe, &medium)))
        {
            // Get the count of files dropped.
            uCount = DragQueryFile((HDROP)medium.hGlobal, (UINT)-1, NULL, 0);

            // Get the first file name from the CF_HDROP.
            if (uCount)
                DragQueryFile((HDROP)medium.hGlobal, 0, m_szFile, 
                              sizeof(m_szFile)/sizeof(TCHAR));

            ReleaseStgMedium(&medium);
        }
    }

    // Duplicate the registry handle. 
    if (hRegKey) 
        RegOpenKeyEx(hRegKey, nullptr, 0L, MAXIMUM_ALLOWED, &m_hRegKey); 
    return S_OK; 
}

CSampleExtHandler는 인터페이스를 구현하는 데 사용되는 클래스의 이름입니다. m_pIDFolder, m_pDataObject, m_szFileNamem_hRegKey 변수는 전달되는 정보를 저장하는 데 사용되는 프라이빗 변수입니다. 간단히 하기 위해 이 예제에서는 데이터 개체에서 하나의 파일 이름만 보유한다고 가정합니다. 데이터 개체에서 FORMATETC 구조를 검색한 후 DragQueryFile 을 사용하여 FORMATETC 구조체의 medium.hGlobal 멤버에서 파일 이름을 추출합니다. 레지스트리 키가 전달되면 메서드는 RegOpenKeyEx 를 사용하여 키를 열고 핸들을 m_hRegKey 할당합니다.

Infotip 사용자 지정

다음 두 가지 방법으로 인포 설명을 사용자 지정할 수 있습니다.

네임스페이스 확장에 대한 고정 문자열을 표시하려면 네임스페이스 확장의 {CLSID} 키에 라는 InfoTip 항목을 만듭니다. 이 예제와 같이 해당 항목의 값을 표시하려는 리터럴 문자열 또는 지역화를 위해 해당 리소스 내에서 리소스 및 인덱스를 지정하는 간접 문자열로 설정합니다.

HKEY_CLASSES_ROOT
   CLSID
      {CLSID}
         InfoTip = InfoTip string for your namespace extension

파일 형식에 대한 고정 문자열을 표시하려면 해당 파일 형식의 ProgID 키에 라는 InfoTip 항목을 만듭니다. 이 예제와 같이 해당 항목의 값을 표시하려는 리터럴 문자열 또는 해당 리소스 내의 리소스 및 인덱스를 지정하는 간접 문자열(지역화를 위해)으로 설정합니다.

HKEY_CLASSES_ROOT
   ProgID
      InfoTip = Resource.dll, 3

셸이 특정 파일 형식에 대한 정보 설명에 특정 파일 속성을 표시하도록 하려면 해당 파일 형식에 대한 ProgID 키에 라는 InfoTip 항목을 만듭니다. 해당 항목의 값을 정식 속성 이름, 형식 식별자(FMTID)/PID(속성 식별자) 쌍 또는 둘 다의 세미콜론으로 구분된 목록으로 설정합니다. 이 값은 속성 목록 문자열로 식별하려면 "prop:"으로 시작해야 합니다. "prop:"을 생략하면 값이 리터럴 문자열로 표시되고 다음과 같이 표시됩니다.

다음 예제에서 propname 은 정식 속성 이름(예: System.Date)이고 {fmtid},pidFMTID/PID 쌍입니다.

HKEY_CLASSES_ROOT
   ProgID
      InfoTip = prop:propname;propname;{fmtid},pid;{fmtid},pid

다음 속성 이름을 사용할 수 있습니다.

속성 이름 설명 검색된 원본
작성자 문서 작성자 PIDSI_AUTHOR
제목 문서 제목 PIDSI_TITLE
제목 제목 요약 PIDSI_SUBJECT
의견 문서 주석 PIDSI_COMMENT 또는 폴더/드라이버 속성
PageCount 페이지 수 PIDSI_PAGECOUNT
Name 이름 표준 폴더 보기
OriginalLocation 원본 파일의 위치 서류 가방 폴더 및 휴지통 폴더
DateDeleted 날짜 파일이 삭제되었습니다. 휴지통 폴더
형식 파일 형식 표준 폴더 세부 정보 보기
크기 파일 크기 표준 폴더 세부 정보 보기
SyncCopyIn OriginalLocation과 동일 OriginalLocation과 동일
수정자 마지막으로 수정한 날짜 표준 폴더 세부 정보 보기
생성일 만든 날짜 표준 폴더 세부 정보 보기
액세스함 마지막으로 액세스한 날짜 표준 폴더 세부 정보 보기
InFolder 파일이 포함된 디렉터리 문서 검색 결과
순위 검색 일치의 품질 문서 검색 결과
FreeSpace 사용 가능한 스토리지 공간 디스크 드라이브
NumberOfVisits 방문 횟수 즐겨찾기 폴더
특성 파일 특성 표준 폴더 세부 정보 보기
회사 회사 이름 PIDDSI_COMPANY
범주 문서 범주 PIDDSI_CATEGORY
Copyright 미디어 저작권 PIDMSI_COPYRIGHT
HTMLInfoTipFile HTML InfoTip 파일 폴더에 대한 Desktop.ini 파일

 

셸 확장 처리기를 사용하여 Windows 검색 향상

셸 확장 처리기를 사용하여 Windows Search 프로토콜 처리기에서 제공하는 사용자 환경을 향상시킬 수 있습니다. 이러한 향상된 기능을 사용하려면 지원되는 셸 확장 처리기가 검색 프로토콜 처리기와 데이터 원본으로 통합되도록 설계되어야 합니다. 셸 확장 처리기와 통합을 통해 Windows Search 프로토콜 처리기를 향상시키는 방법에 대한 자세한 내용은 아이콘, 미리 보기 및 바로 가기 메뉴 추가를 참조하세요. Windows Search 프로토콜 처리기에 대한 자세한 내용은 프로토콜 처리기 개발을 참조하세요.

셸 확장 처리기 등록

Shell 확장 처리기 개체를 등록해야 셸에서 사용할 수 있습니다. 이 섹션은 셸 확장 처리기를 등록하는 방법에 대한 일반적인 설명입니다.

셸 확장 처리기를 만들거나 변경할 때마다 SHChangeNotify를 사용하여 변경했음을 시스템에 알리고 SHCNE_ASSOCCHANGED 이벤트를 지정하는 것이 중요합니다. SHChangeNotify를 호출하지 않으면 시스템이 다시 부팅될 때까지 변경 내용이 인식되지 않을 수 있습니다.

모든 COM 개체와 마찬가지로 UUIDGEN.exe 같은 도구를 사용하여 처리기에 대한 GUID를 만들어야 합니다. 이름이 GUID의 문자열 형식인 HKEY_CLASSES_ROOT\CLSID 아래에 키를 만듭니다. 셸 확장 처리기는 In-process 서버이므로 기본값이 처리기의 DLL 경로로 설정된 GUID 키 아래에 InProcServer32 키를 만들어야 합니다. 아파트 스레딩 모델을 사용합니다.

셸이 셸 확장 처리기를 포함할 수 있는 작업을 수행할 때마다 적절한 레지스트리 키를 확인합니다. 따라서 확장 처리기가 등록된 키는 호출 시기를 제어합니다. instance 경우 셸에서 파일 형식의 멤버에 대한 바로 가기 메뉴를 표시할 때 라는 바로 가기 메뉴 처리기를 사용하는 것이 일반적입니다. 이 경우 처리기는 파일 형식의 ProgID 키 아래에 등록되어야 합니다.

처리기 이름

셸 확장 처리기를 사용하도록 설정하려면 ProgID(파일 형식의 경우) 또는 Shell 개체 형식 이름(미리 정의된 셸 개체의 경우)의 ShellEx 하위 키 아래에 처리기 하위 키 이름(아래 참조)을 사용하여 하위 키를 만듭니다.

예를 들어 MyProgram.1에 대한 바로 가기 메뉴 확장 처리기를 등록하려면 먼저 다음 하위 키를 만듭니다.

HKEY_CLASSES_ROOT
   MyProgram.1
      ShellEx
         ContextMenuHandlers

다음 처리기의 경우 이름이 Shell 확장의 CLSID 문자열 버전인 "처리기 하위 키 이름" 키 아래에 하위 키를 만듭니다. 여러 하위 키를 만들어 처리기 하위 키 이름 키 아래에 여러 확장을 등록할 수 있습니다.

Handler 인터페이스 처리기 하위 키 이름
바로 가기 메뉴 처리기 IContextMenu ContextMenuHandlers
Copyhook 처리기 ICopyHook CopyHookHandlers
끌어서 놓기 처리기 IContextMenu DragDropHandlers
속성 시트 처리기 IShellPropSheetExt PropertySheetHandlers
열 공급자 처리기(Windows Vista에서는 사용되지 않음) IColumnProvider ColumnHandlers

 

다음 처리기의 경우 "처리기 하위 키 이름" 키의 기본값은 셸 확장의 CLSID 문자열 버전입니다. 이러한 처리기에 대해 하나의 확장만 등록할 수 있습니다.

Handler 인터페이스 처리기 하위 키 이름
데이터 처리기 Idataobject DataHandler
드롭 처리기 Idroptarget DropHandler
아이콘 처리기 IExtractIconA/W IconHandler
이미지 처리기 IExtractImage {BB2E617C-0920-11d1-9A0B-00C04FC2D6C1}
썸네일 이미지 처리기 IThumbnailProvider {E357FCCD-A995-4576-B01F-234630154E96}
정보 팁 처리기 IQueryInfo {00021500-0000-0000-C000-000000000046}
셸 링크(ANSI) IShellLinkA {000214EE-0000-0000-C000-000000000046}
셸 링크(UNICODE) IShellLinkW {000214F9-0000-0000-C000-000000000046}
구조적 스토리지 IStorage {0000000B-0000-0000-C000-000000000046}
메타데이터 IPropertyStore PropertyHandler
메타데이터 IPropertySetStorage(Windows Vista에서는 사용되지 않음) PropertyHandler
시작 메뉴에 고정 IStartMenuPinnedList {a2a9545d-a0c2-42b4-9708-a0b2badd77c8}
작업 표시줄에 고정 {90AA3A4E-1CBA-4233-B8BB-535773D48449}

 

시작 메뉴에 고정을 추가하고 작업 표시줄에 고정을 항목의 바로 가기 메뉴에 추가하도록 지정된 하위 키는 IsShortCut 항목을 포함하는 파일 형식에만 필요합니다.

Windows Vista에서 열 공급자 처리기에 대한 지원이 제거되었습니다. 또한 Windows Vista부터 IPropertySetStorageIPropertyStore를 위해 더 이상 사용되지 않습니다.

IExtractImage는 계속 지원되지만 Windows Vista 이상에서는 IThumbnailProvider가 선호됩니다.

미리 정의된 셸 개체

Shell은 파일 형식과 동일한 방식으로 확장할 수 있는 HKEY_CLASSES_ROOT 아래에 추가 개체를 정의합니다. 예를 들어 모든 파일에 대한 속성 시트 처리기를 추가하려면 PropertySheetHandlers 키 아래에 등록할 수 있습니다.

HKEY_CLASSES_ROOT
   *
      shellex
         PropertySheetHandlers

다음 표에서는 확장 처리기를 등록할 수 있는 HKEY_CLASSES_ROOT 다양한 하위 키를 제공합니다. 나열된 모든 하위 키에는 많은 확장 처리기를 등록할 수 없습니다. 자세한 내용은 특정 처리기의 설명서를 참조하세요.

하위 키 설명 가능한 처리기 버전
* 모든 파일 바로 가기 메뉴, 속성 시트, 동사(아래 참조) 모두
AllFileSystemObjects 모든 파일 및 파일 폴더 바로 가기 메뉴, 속성 시트, 동사 4.71
폴더 모든 폴더 바로 가기 메뉴, 속성 시트, 동사 모두
디렉터리 파일 폴더 바로 가기 메뉴, 속성 시트, 동사 모두
Directory\Background 파일 폴더 배경 바로 가기 메뉴만 4.71
드라이브 MyComputer의 모든 드라이브(예: "C:\" 바로 가기 메뉴, 속성 시트, 동사 모두
Network 전체 네트워크(내 네트워크 위치 아래) 바로 가기 메뉴, 속성 시트, 동사 모두
Network\Type\ # #형식의 모든 개체(아래 참조) 바로 가기 메뉴, 속성 시트, 동사 4.71
Netshare 모든 네트워크 공유 바로 가기 메뉴, 속성 시트, 동사 4.71
NetServer 모든 네트워크 서버 바로 가기 메뉴, 속성 시트, 동사 4.71
network_provider_name 네트워크 공급자 "network_provider_name"에서 제공하는 모든 개체 바로 가기 메뉴, 속성 시트, 동사 모두
프린터 모든 프린터 바로 가기 메뉴, 속성 시트 모두
AudioCD CD 드라이브의 오디오 CD 동사만 모두
Dvd DVD 드라이브(Windows 2000) 바로 가기 메뉴, 속성 시트, 동사 4.71

 

참고:

  • 파일 폴더 배경 바로 가기 메뉴는 파일 폴더 내에서 마우스 오른쪽 단추를 클릭하여 액세스하지만 폴더의 내용을 통해 액세스하지는 않습니다.
  • "동사"는 HKEY_CLASSES_ROOT\하위 키\\동사 아래에 등록된 특수 명령입니다.
  • 네트워크\형식\#의 경우 "#"은 10진수의 네트워크 공급자 유형 코드입니다. 네트워크 공급자 유형 코드는 네트워크 유형의 상위 단어입니다. 네트워크 유형 목록은 Winnetwk.h 헤더 파일(WNNC_NET_* 값)에 제공됩니다. 예를 들어 WNNC_NET_SHIVA 0x00330000 있으므로 해당 형식 키는네트워크\\ 유형51에 HKEY_CLASSES_ROOT\.
  • "network_provider_name"는 WNetGetProviderName에서 지정한 네트워크 공급자 이름이며 공백은 밑줄로 변환됩니다. 예를 들어 Microsoft 네트워킹 네트워크 공급자가 설치된 경우 공급자 이름은 "Microsoft Windows 네트워크"이고 해당 network_provider_nameMicrosoft_Windows_Network.

확장 처리기 등록의 예

특정 처리기를 사용하도록 설정하려면 처리기의 이름을 사용하여 확장 처리기 형식 키 아래에 하위 키를 만듭니다. 셸은 처리기의 이름을 사용하지 않지만 해당 형식 하위 키 아래의 다른 모든 이름과 달라야 합니다. 이름 하위 키의 기본값을 처리기 GUID의 문자열 형식으로 설정합니다.

다음 예제에서는 예제 .myp 파일 형식을 사용하여 바로 가기 메뉴 및 속성 시트 확장명 처리기를 사용하도록 설정하는 레지스트리 항목을 보여 줍니다.

HKEY_CLASSES_ROOT
   .myp
      (Default) = MyProgram.1
   CLSID
      {00000000-1111-2222-3333-444444444444}
         InProcServer32
            (Default) = C:\MyDir\MyCommand.dll
            ThreadingModel = Apartment
      {11111111-2222-3333-4444-555555555555}
         InProcServer32
            (Default) = C:\MyDir\MyPropSheet.dll
            ThreadingModel = Apartment
   MyProgram.1
      (Default) = MyProgram Application
      Shellex
         ContextMenuHandler
            MyCommand
               (Default) = {00000000-1111-2222-3333-444444444444}
         PropertySheetHandlers
            MyPropSheet
               (Default) = {11111111-2222-3333-4444-555555555555}

이 섹션에서 설명하는 등록 절차는 모든 Windows 시스템에 대해 따라야 합니다.

In-Process 확장 구현에 대한 지침