IHomeGroup::IsMember-Methode (shobjidl_core.h)

Artikel
03/04/2024

Bestimmt, ob der lokale Computer Mitglied einer Heimnetzgruppe ist.

Syntax

HRESULT IsMember(
  [out] BOOL *member
);

Parameter

[out] member

Typ: BOOL*

Wenn diese Methode erfolgreich zurückgegeben wird, empfängt TRUE , wenn der lokale Computer Mitglied einer Heimnetzgruppe ist. andernfalls FALSE.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Der folgende Codeausschnitt zeigt, wie Sie eine instance von IHomeGroup erstellen und IHomeGroup::IsMember aufrufen.

#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);

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 (einschließlich Shobjidl.h)

Weitere Informationen