Zum Hauptinhalt springen

HdlEnum

obj -> HdlEnum([int1]) : handle​

Ausführbar von Clients mit grafischer Oberfläche Ausführbar vom Server Ausführbar von Clients mit Programmierschnittstelle Ausführbar von der Web-Schnittstelle Ausführbar vom Druckprozessor Ausführbar von der ODBC-Schnittstelle Ausführbar vom SOA-Service

Deskriptor enumerieren

Details

Mit dieser Funktion können alle aktiven Deskriptoren enumeriert werden.

Wird als Vorgänger-Deskriptor (obj) 0 angegeben, wird der erste Deskriptor, sonst der nachfolgende Deskriptor ermittelt. Aufgrund der internen Verwaltung der Deskriptoren werden diese nicht in numerisch aufsteigender Reihenfolge ermittelt.

Optional kann ein Deskriptor-Typ (int1) (siehe _HdlType) angegeben werden, um nur Deskriptoren dieses Typs zu ermitteln.

info

Sollen alle Deskriptoren eines Typs entfernt werden, muss vor dem Entfernen der nächste Deskriptor ermittelt werden.

Resultate

Ist der Vorgänger-Deskriptor (obj) ungültig, oder kein weiterer Deskriptor vorhanden, wird 0 zurückgegeben. Sonst wird der nächste Deskriptor zurückgegeben.

Beispiele

// Alle Deskriptoren enumerieren
for  tHdl # HdlEnum(0);
loop tHdl # tHdl->HdlEnum();
while (tHdl > 0)
{
  // ...
}

// Alle offenen Memory-Objekte schließen
tHdl # HdlEnum(0, _HdlMem);
while (tHdl > 0)
{
  if (tHdlPrev > 0)
    tHdlPrev->MemFree();

  tHdlPrev # tHdl;
  tHdl     # tHdl->HdlEnum(_HdlMem);
}
// letztes Memory-Objekt auch schließen
if (tHdlPrev > 0)
  tHdlPrev->MemFree();