Méthode IHomeGroup ::IsMember (shobjidl_core.h)

Article
03/02/2024

Détermine si l’ordinateur local est membre d’un groupe résidentiel.

Syntaxe

HRESULT IsMember(
  [out] BOOL *member
);

Paramètres

[out] member

Type : BOOL*

Lorsque cette méthode retourne correctement, reçoit TRUE si l’ordinateur local est membre d’un groupe résidentiel ; sinon, FALSE.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

L’extrait de code suivant montre comment créer un instance d’IHomeGroup et appeler IHomeGroup ::IsMember.

#include "shobjidl.h"
#include "atlbase.h"   // For COM smart pointers
                    
CComPtr<IHomeGroup> spHomeGroup;
HRESULT hr = S_OK;
BOOL fIsHGMember = FALSE;

// Initialize the COM subsystem.
hr = CoInitialize(NULL);
if (FAILED(hr)) return hr;

// Create an instance of IHomeGroup.
hr = CoCreateInstance(CLSID_HomeGroup, 
                      NULL, 
                      CLSCTX_INPROC_SERVER, 
                      IID_PPV_ARGS(&spHomeGroup));

if (FAILED(hr)) return hr;

// fIsHGMember receives the value TRUE if the local computer is a member of a 
// HomeGroup, or FALSE if the computer is not a HomeGroup member.
hr = spHomeGroup->IsMember(&fIsHGMember);

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shobjidl_core.h (inclure Shobjidl.h)

Voir aussi

Partager via