IOPCServer::GetGroupByName

Previous  Top  Next

HRESULT GetGroupByName(
   [in, string] LPCWSTR szName,
   [in] REFIID riid,
   [out, iid_is(riid)] LPUNKNOWN * ppUnk
   );

Descrizione
Dato il nome di un group privato(precedentemente creato dallo stesso client), restituisce un puntatore aggiuntivo all'interfaccia. Usa GetPublicGroupByName per unire ai groups pubblici .

Parametri	Descrizione
szName	Il nome del group. E' il group che deve essere stato creato dal chiamante.
riid	Il tipo di interfaccia desiderata per il group (e.g. IOPCItemMgt)
ppUnk	Puntatore a dove, il puntatore all'interfaccia del group, deve essere restituito. Viene restituito NULL per oqni HRESULT diverso da S_OK.

Codici restituiti

Return Code	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.

Commenti
Questa funzione può essere usata per riconnettersi a un group privato per il quale tutti i puntatori delle interfacce sono stati rilasciati.
Il client deve rilasciare l'interfaccia resituitagli, quando non ha più bisogno di essa.
Se necessario, il client può ottenere l'identificatore hServerGroup tramite IOPCGroupStateMgt:: GetState