IHomeGroup：：ShowSharingWizard 方法 (shobjidl_core.h)

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

傳回碼	Description
ERROR_CANCELLED	使用者已取消精靈。使用 HRESULT_FROM_WIN32 來擷取此錯誤碼。
E_UNEXPECTED	計算機未加入首頁群組，或網路或首頁群組的狀態不是允許共用 (，例如未連線到網路或進行中另一個共享作業) 。
E_NOINTERFACE	方法是從多線程 Apartment 啟動， (MTA) 線程。
E_INVALIDARG	sharingchoices 參數為 NULL。

備註

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

規格需求

需求	值
最低支援的用戶端	Windows 7 [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 R2 [僅限桌面應用程式]
目標平台	Windows
標頭	shobjidl_core.h (包含 Shobjidl.h)

共用方式為