TsgcWebSocketServer_HTTPAPI › Methods › ShareList
Verkrijgt een gedeeld (alleen-lezen) vergrendeling op de interne verbindingslijst en retourneert deze voor gelijktijdige opsomming.
TList __fastcall ShareList();De actieve TList van TsgcWSConnection-exemplaren die door de server worden bewaard. De aanroeper moet de lijst als alleen-lezen behandelen en moet de vergrendeling vrijgeven door UnShareList aan te roepen zodra hij klaar is. (TList)
ShareList vergrendelt de interne SRW-lock (Slim Reader/Writer) van de lijst in gedeelde modus, waardoor meerdere threads tegelijk de verbindingstabel kunnen doorlopen zonder elkaar te blokkeren. Gebruik het alleen wanneer u de verbindingsstatus moet lezen (doorlopen, tellen, een GUID opzoeken) — het is aanzienlijk goedkoper dan LockList, dat de exclusieve schrijfvergrendeling neemt en toegang serialiseert. Voeg nooit items toe, verwijder of muteer items terwijl u de gedeelde vergrendeling vasthoudt; upgrade dan naar LockList. Elke aanroep van ShareList moet worden gekoppeld aan precies één aanroep van UnShareList, bij voorkeur in een try..finally-blok, anders blijft de lijst vergrendeld en kunnen nieuwe verbindingen niet worden geregistreerd.
oList = oServer->ShareList();
try {
for (int i = 0; i < oList->Count; i++)
DoSomething((TsgcWSConnection*)oList->Items[i]);
}
__finally {
oServer->UnShareList();
}