IOPCPublicGroupStateMgt::MoveToPublic

Previous  Top  Next

HRESULT MoveToPublic(

void

);

Descrizione
Converte un gruppo privato in un gruppo pubblico. Il gruppo dovrà avere un nome univoco e che non deve dare adito ad equivoci con altri gruppi pubblici. Lo stato del gruppo (active, UpdateRate, IAdvise connections, etc.) per il client chiamante non subirà conseguenze.

Parametri	Descrizione
Void

Codici Restituiti

Codici Restituiti	Descrizione
S_OK	L'operazione ha avuto successo.
E_OUTOFMEMORY	Memoria insufficiente.
E_FAIL	Operazione fallita.
OPC_E_DUPLICATENAME	Duplicazione del nome non consentita.

Commenti
Un gruppo pubblico non può essere convertito in un gruppo privato, ma può essere clonato per ottenerne una copia privata.
Per i gruppi pubblici, l'update rate, il client group handle e lo stato active sono mantenuti come dati 'istanza' per ciascun client.
Si richiede che il client setti il client group Handle prima che ogni altra funzione asincrona sia effettuata su un public group. Dopo che un gruppo è reso pubblico altri client possono connettersi.
Quando un gruppo è reso pubblico non può essere aggiunto o cancellato nessun item.
Per gli item in un gruppo, il client handle, stato active e data type richiesto sono mantenuti come dati 'istanza' per ciascun client.