IHomeGroup::ShowSharingWizard 메서드(shobjidl_core.h)

아티클
08/08/2024

사용자가 홈 그룹을 만들 수 있는 마법사를 표시한 다음 마법사를 통해 사용자가 선택한 공유 옵션을 검색합니다.

구문

HRESULT ShowSharingWizard(
  [in]  HWND                    owner,
  [out] HOMEGROUPSHARINGCHOICES *sharingchoices
);

매개 변수

[in] owner

형식: HWND

알림에 사용되는 마법사의 소유자 창 핸들입니다. 이 값은 NULL일 수 있습니다.

[out] sharingchoices

형식: HOMEGROUPSHARINGCHOICES*

이 메서드가 성공적으로 반환될 때 홈 그룹과 공유할 마법사를 통해 선택한 라이브러리 및 디바이스를 나타내는 다음 값 중 하나 이상을 수신하는 값에 대한 포인터입니다.

HGSC_NONE(0x00000000)

0x00000000. 홈 그룹 옵션이 선택되지 않았습니다.

HGSC_MUSICLIBRARY(0x00000001)

0x00000001. 음악 라이브러리가 홈 그룹과 공유되도록 선택되었습니다.

HGSC_PICTURESLIBRARY(0x00000002)

0x00000002. 사진 라이브러리가 홈 그룹과 공유되도록 선택되었습니다.

HGSC_VIDEOSLIBRARY(0x00000004)

0x00000004. 홈 그룹과 공유하도록 비디오 라이브러리가 선택되었습니다.

HGSC_DOCUMENTSLIBRARY(0x00000008)

0x00000008. 홈 그룹과 공유하도록 문서 라이브러리가 선택되었습니다.

HGSC_PRINTERS(0x00000010)

0x00000010. 설치된 프린터 디바이스가 홈 그룹과 공유되도록 선택되었습니다.

반환 값

형식: HRESULT

성공하면 S_OK 반환하고, 그렇지 않으면 다음을 포함하여 표준 오류 값을 반환합니다.

반환 코드	설명
ERROR_CANCELLED	사용자가 마법사를 취소했습니다. HRESULT_FROM_WIN32 사용하여 이 오류 코드를 추출합니다.
E_UNEXPECTED	컴퓨터가 홈 그룹에 조인되지 않았거나 네트워크 또는 홈 그룹이 공유를 허용하는 상태가 아닙니다(예: 네트워크에 연결되지 않거나 다른 공유 작업이 진행 중임).
E_NOINTERFACE	이 메서드는 MTA(다중 스레드 아파트) 스레드에서 시작되었습니다.
E_INVALIDARG	sharingchoices 매개 변수는 NULL입니다.

설명

이 메서드는 STA(단일 스레드 아파트) 스레드에서 호출해야 합니다.

예제

다음 코드에서는 ShowSharingWizard를 사용하는 예제를 보여 줍니다.

HRESULT hr = CoInitializeEx(NULL, COINIT_APARTMENTTHREADED);
if (SUCCEEDED(hr))
{
    IHomeGroup *phg;
    
    hr = CoCreateInstance(CLSID_HomeGroup, NULL, CLSCTX_INPROC_SERVER, IID_PPV_ARGS(&phg));
    if (SUCCEEDED(hr))
    {
        HOMEGROUPSHARINGCHOICES sharingchoices;

        hr = phg->ShowSharingWizard(NULL, &sharingchoices);
        if (SUCCEEDED(hr))
        {
            \\ The user selected to share.
            
            if (sharingchoices & HGSC_MUSICLIBRARY)
            {
                \\ Music
            }
            if (sharingchoices & HGSC_PICTURESLIBRARY)
            {
                \\ Pictures
            }
            if (sharingchoices & HGSC_VIDEOSLIBRARY)
            {
                \\ Videos
            }
            if (sharingchoices & HGSC_DOCUMENTSLIBRARY)
            {
                \\ Documents
            }
            if (sharingchoices & HGSC_PRINTERS)
            {
                \\ Printers
            }
        }
        phg->Release();
    }
    CoUninitialize();
}

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 7 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 R2 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	shobjidl_core.h(Shobjidl.h 포함)

다음을 통해 공유