IShellWindows 인터페이스(exdisp.h)

아티클
08/23/2023

열린 Shell 창의 컬렉션에 대한 액세스를 제공합니다.

상속

IShellWindows 인터페이스는IDispatch 인터페이스에서 상속됩니다. IShellWindows 에는 다음과 같은 유형의 멤버도 있습니다.

메서드

IShellWindows 인터페이스에는 이러한 메서드가 있습니다.


IShellWindows::_NewEnum Shell 창의 컬렉션에 대한 열거자를 검색합니다.
IShellWindows::FindWindowSW Shell 창 컬렉션에서 창을 찾아 창의 핸들 및 IDispatch 인터페이스를 반환합니다.
IShellWindows::get_Count Shell 창 컬렉션의 창 수를 가져옵니다.
IShellWindows::Item 지정된 인덱스에서 등록된 셸 창을 반환합니다.
IShellWindows::OnActivated 셸 창의 활성화 상태가 변경되면 발생합니다.
IShellWindows::OnCreated 프레임에 대해 새 셸 창을 만들 때 발생합니다.
IShellWindows::OnNavigate 셸 창이 새 위치로 이동될 때 발생합니다.
IShellWindows::P rocessAttachDetach 더 이상 사용되지 않습니다. 항상 S_OK 반환합니다.
IShellWindows::Register 열린 창을 셸 창으로 등록합니다. 창은 핸들로 지정됩니다.
IShellWindows::RegisterPending 보류 중인 창을 셸 창으로 등록합니다. 창은 절대 PIDL로 지정됩니다.
IShellWindows::Revoke 셸 창의 등록을 취소하고 셸 창 컬렉션에서 창을 제거합니다.

설명

셸 창은 IShellWindows::Register 또는 IShellWindows::RegisterPending을 호출하여 등록된 창입니다. 등록 시 지정된 창이 Shell 창의 컬렉션에 추가되고 컬렉션 내의 창을 고유하게 식별하는 쿠키가 부여됩니다. IShellWindows::Revoke를 호출하여 창을 등록 취소할 수 있습니다.

Shell 창 컬렉션에는 파일 탐색기 창과 웹 브라우저 창 인터넷 Explorer 및 타사 웹 브라우저)가 포함됩니다. 일반적으로 각 셸 창은 IDispatch를 구현합니다. IShellWindows::Item 및 IShellWindows::FindWindowSW 는 셸 창의 IDispatch 인터페이스에 액세스하는 방법을 제공합니다. 자세한 내용은 디스패치 인터페이스 및 자동화 함수를 참조하세요.

IID	IID_IShellWindows(85CB6900-4D95-11CF-960C-0080C7F4EE85)
CLSID	CLSID_ShellWindows(9BA05972-F6A8-11CF-A442-00A0C90A8F39)

다음 예제에서는 IShellWindows instance 검색하는 방법을 보여 줍니다.

#include "exdisp.h"
                
...

IShellWindows *psw;
HRESULT hr;

hr = CoInitialize(NULL);
if (SUCCEEDED(hr))
{
    hr = CoCreateInstance(
        CLSID_ShellWindows,
        NULL,
        CLSCTX_ALL,
        IID_IShellWindows,
        (void**)&psw
    );
    
    if (SUCCEEDED(hr))
    {
        // Use the IShellWindows instance...
        
        psw->Release();
    }
}