IHomeGroup::ShowSharingWizard-Methode (shobjidl_core.h)

Artikel
03/13/2024

Zeigt einen Assistenten an, der es einem Benutzer ermöglicht, eine Startgruppe zu erstellen, und ruft dann die Freigabeoptionen ab, die der Benutzer über den Assistenten ausgewählt hat.

Syntax

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

Parameter

[in] owner

Typ: HWND

Handle des Besitzerfensters des Assistenten, das für Benachrichtigungen verwendet wird. Dieser Wert kann NULL sein.

[out] sharingchoices

Typ: HOMEGROUPSHARINGCHOICES*

Zeiger auf einen Wert, der bei erfolgreicher Rückgabe dieser Methode einen oder mehrere der folgenden Werte empfängt, die die Bibliotheken und Geräte angeben, die über den Assistenten für die Freigabe für die Startgruppe ausgewählt wurden.

HGSC_NONE (0x00000000)

0x00000000. Keine der Optionen für die Startgruppe wurde ausgewählt.

HGSC_MUSICLIBRARY (0x00000001)

0x00000001. Die Musikbibliothek wurde für die Freigabe für die Startgruppe ausgewählt.

HGSC_PICTURESLIBRARY (0x00000002)

0x00000002. Die Bildbibliothek wurde für die Freigabe für die Startgruppe ausgewählt.

HGSC_VIDEOSLIBRARY (0x00000004)

0x00000004. Die Videobibliothek wurde für die Freigabe für die Startgruppe ausgewählt.

HGSC_DOCUMENTSLIBRARY (0x00000008)

0x00000008. Die Dokumentbibliothek wurde für die Freigabe für die Startgruppe ausgewählt.

HGSC_PRINTERS (0x00000010)

0x00000010. Installierte Druckergeräte wurden für die Freigabe für die Startgruppe ausgewählt.

Rückgabewert

Typ: HRESULT

Gibt bei erfolgreicher Ausführung S_OK oder andernfalls einen Standardfehlerwert zurück, einschließlich der folgenden:

Rückgabecode	Beschreibung
ERROR_CANCELLED	Der Benutzer hat den Assistenten abgebrochen. Verwenden Sie HRESULT_FROM_WIN32 , um diesen Fehlercode zu extrahieren.
E_UNEXPECTED	Der Computer ist nicht mit einer Startgruppe verbunden, das Netzwerk oder die Startgruppe befindet sich nicht in einem Zustand, der die Freigabe zulässt (z. B. nicht mit dem Netzwerk verbunden oder ein anderer Freigabevorgang ausgeführt wird).
E_NOINTERFACE	Die -Methode wurde über einen MTA-Thread (Multithreaded Apartment) gestartet.
E_INVALIDARG	Der sharingchoices-Parameter ist NULL.

Hinweise

Diese Methode muss aus einem STA-Thread (Singlethreaded Apartment) aufgerufen werden.

Beispiele

Der folgende Code zeigt ein Beispiel für die Verwendung von 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();
}

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl_core.h (shobjidl.h einschließen)

Freigeben über