DPA_GetPtrPtr-Makro (dpa_dsa.h)

Ruft den Zeiger auf das interne Zeigerarray eines dynamischen Zeigerarrays (DPA) ab.

Syntax

void DPA_GetPtrPtr(
  [in]  hdpa
);

Parameter

[in] hdpa

Ein Handle für eine vorhandene DPA.

Rückgabewert

Keine

Bemerkungen

Anwendungen können den Rückgabewert verwenden, um den Inhalt des DPA direkt zu bearbeiten, anstatt Funktionen wie DPA_SetPtr zu verwenden. Der Rückgabewert wird durch jeden Vorgang ungültig, der die Anzahl der Elemente im DPA ändert oder die DPA zerstört. Nach dem Aufrufen der Funktion DPA_InsertPtr für einen DPA sind beispielsweise alle internen Zeiger, die durch Aufrufen des Makros DPA_GetPtrPtr für dieselbe DPA abgerufen werden, nicht mehr gültig.

Anforderungen