IHomeGroup：：ShowSharingWizard 方法 (shobjidl_core.h)

顯示可讓使用者建立首頁群組的精靈，然後擷取使用者透過精靈選取的共享選項。

語法

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，否則傳回標準錯誤值，包括下列專案：

備註

這個方法必須從單個線程 Apartment (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();
}

規格需求