IHomeGroup::ShowSharingWizard-Methode (shobjidl_core.h)
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 |
---|---|
|
Der Benutzer hat den Assistenten abgebrochen. Verwenden Sie HRESULT_FROM_WIN32 , um diesen Fehlercode zu extrahieren. |
|
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). |
|
Die -Methode wurde über einen MTA-Thread (Multithreaded Apartment) gestartet. |
|
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) |