Metode IHomeGroup::ShowSharingWizard (shobjidl_core.h)

Artikel
08/26/2023

Menampilkan panduan yang memungkinkan pengguna membuat Grup Beranda, lalu mengambil opsi berbagi yang dipilih pengguna melalui panduan.

Sintaks

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

Parameter

[in] owner

Jenis: HWND

Menangani jendela pemilik wizard, digunakan untuk pemberitahuan. Nilai ini bisa NULL.

[out] sharingchoices

Jenis: HOMEGROUPSHARINGCHOICES*

Penunjuk ke nilai yang, ketika metode ini berhasil dikembalikan, menerima satu atau beberapa nilai berikut yang menunjukkan pustaka dan perangkat yang dipilih melalui wizard untuk dibagikan dengan Grup Beranda.

HGSC_NONE (0x00000000)

0x00000000. Tidak ada opsi Grup Beranda yang dipilih

HGSC_MUSICLIBRARY (0x00000001)

0x00000001. Pustaka Musik dipilih untuk dibagikan dengan Grup Beranda.

HGSC_PICTURESLIBRARY (0x00000002)

0x00000002. Pustaka Gambar dipilih untuk dibagikan dengan Grup Beranda..

HGSC_VIDEOSLIBRARY (0x00000004)

0x00000004. Pustaka Video dipilih untuk dibagikan dengan Grup Beranda.

HGSC_DOCUMENTSLIBRARY (0x00000008)

0x00000008. Pustaka Dokumen dipilih untuk dibagikan dengan Grup Beranda.

HGSC_PRINTERS (0x00000010)

0x00000010. Perangkat pencetak yang terinstal dipilih untuk dibagikan dengan Grup Beranda.

Mengembalikan nilai

Jenis: HRESULT

Mengembalikan S_OK jika berhasil, atau nilai kesalahan standar jika tidak, termasuk yang berikut ini:

Menampilkan kode	Deskripsi
ERROR_CANCELLED	Pengguna membatalkan wizard. Gunakan HRESULT_FROM_WIN32 untuk mengekstrak kode galat ini.
E_UNEXPECTED	Komputer tidak tergabung ke Grup Rumah atau jaringan atau Grup Rumah tidak dalam keadaan yang memperbolehkan berbagi (seperti tidak tersambung ke jaringan atau operasi berbagi lain sedang berlangsung).
E_NOINTERFACE	Metode ini diluncurkan dari utas multithreaded apartment (MTA).
E_INVALIDARG	Parameter sharingchoices adalah NULL.

Keterangan

Metode ini harus dipanggil dari utas apartemen berulir tunggal (STA).

Contoh

Kode berikut menunjukkan contoh penggunaan 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();
}

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 R2 [hanya aplikasi desktop]
Target Platform	Windows
Header	shobjidl_core.h (termasuk Shobjidl.h)

Bagikan melalui