IOPCServerPublicGroups:: GetPublicGroupByName

Previous  Top  Next

HRESULT GetPublicGroupByName(

[in, string] LPCWSTR szName,

[in] REFIID riid,

[out, iid_is(riid)] LPUNKNOWN * ppUnk

);

Descrizione
Connette il client a un group pubblico. Restituisce un puntatore all' interfaccia del group.

Parametri	Descrizione
szName	Nome del group a cui connettersi
riid	Interfaccia richiesta
ppUnk	Punta al luogo in cui si vuole memorizzare l'interfaccia. Viene restituito NULL per ogni HRESULT diverso da S_OK

Codici Restituiti

Codici Restituiti	Descrizione
E_FAIL	L'operazione non ha avuto successo.
E_OUTOFMEMORY	Non c'è memoria a sufficienza.
E_INVALIDARG	Un argomento passato alla funzione era invalido
S_OK	L'operazione ha avuto successo.
E_NOINTERFACE	L'interfaccia(riid) richiesta non è supportata dal server.
OPC_E_NOTFOUND	Il Group pubblico richiesto non è stato trovato.

Commenti

Se necessario, il client può ottenere l'identificatore hServerGroup attraverso IOPCGroupStateMgt:: GetState.
Quando l'ultima interfaccia del client relativa al group pubblico viene rilasciata, il client è effettivamente disconnesso dal group. A questo punto il server dovrebbe rilasciare qualsiasi risorsa o dato associati col collegamento del client al group pubblico. Non è necessario per il cliente chiamare RemoveGroup o RemovePublicGroup per liberare queste risorse