System.IUnknown.AddRef
C++
virtual ULONG STDMETHODCALLTYPE AddRef( void) = 0;
Eigenschaften
| Typ | Sichtbarkeit | Quelle | Unit | Übergeordnet |
|---|---|---|---|---|
| function | public | unknwn.h | System | IUnknown |
Beschreibung
Inkrementiert den Referenzzähler für dieses Interface.
In den meisten Implementierungen inkrementiert AddRef den Referenzzähler für das Interface und gibt den neuen Referenzzähler zurück. Wird das Interface von der aufrufenden Routine nicht mehr benötigt, muss der Benutzer die Methode Release aufrufen, die den Referenzzähler dekrementiert. Sobald der Referenzzähler den Wert Null erreicht, wird das Objekt automatisch freigegeben.
Hinweise:
- Implementierungsobjekte können AddRef und Release implementieren, sodass keine Referenzzählung erfolgt. Bei solchen Objekten erreicht der Referenzzähler niemals den Wert Null, sodass das Objekt nicht automatisch freigegeben wird. In diesen Fällen muss die Anwendung für die Freigabe des Objekts sorgen.
- Rufen Sie diese Methode für jede neue Kopie dieses Interface-Zeigers auf, den Sie erstellen.