Método IHomeGroup::ShowSharingWizard (shobjidl_core.h)

Muestra un asistente que permite a un usuario crear un grupo principal y, a continuación, recuperar las opciones de uso compartido que el usuario seleccionó a través del asistente.

Sintaxis

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

Parámetros

[in] owner

Tipo: HWND

Identificador de la ventana de propietario del asistente, que se usa para las notificaciones. Este valor puede ser NULL.

[out] sharingchoices

Tipo: HOMEGROUPSHARINGCHOICES*

Puntero a un valor que, cuando este método devuelve correctamente, recibe uno o varios de los siguientes valores que indican las bibliotecas y los dispositivos elegidos a través del asistente para compartirse con el grupo principal.

HGSC_NONE (0x00000000)

0x00000000. No se seleccionó ninguna de las opciones del grupo principal

HGSC_MUSICLIBRARY (0x00000001)

0x00000001. La biblioteca de música se seleccionó para compartirse con el grupo principal.

HGSC_PICTURESLIBRARY (0x00000002)

0x00000002. La biblioteca imágenes se seleccionó para compartirla con el grupo principal.

HGSC_VIDEOSLIBRARY (0x00000004)

0x00000004. La biblioteca videos se seleccionó para compartirse con el grupo principal.

HGSC_DOCUMENTSLIBRARY (0x00000008)

0x00000008. La biblioteca Documentos se seleccionó para compartirse con el grupo principal.

HGSC_PRINTERS (0x00000010)

0x00000010. Los dispositivos de impresora instalados se seleccionaron para compartirse con el grupo principal.

Valor devuelto

Tipo: HRESULT

Devuelve S_OK si se ejecuta correctamente o un valor de error estándar de lo contrario, incluido lo siguiente:

Comentarios

Se debe llamar a este método desde un subproceso de apartamento de un solo subproceso (STA).

Ejemplos

En el código siguiente se muestra un ejemplo de uso de 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();
}

Requisitos