IUnknown_AtomicRelease-Funktion (shlwapi.h)
Gibt einen COM-Zeiger (Component Object Model) frei und legt ihn auf NULL fest.
Syntax
void IUnknown_AtomicRelease(
[in, out, optional] void **ppunk
);
Parameter
[in, out, optional] ppunk
Typ: void**
Die Adresse eines Zeigers auf eine COM-Schnittstelle.
Rückgabewert
Keine
Bemerkungen
Wenn ppunk auf einen NULL-Zeiger zeigt, wird kein Vorgang ausgeführt. Andernfalls wird davon ausgegangen, dass ppunk die Adresse eines COM-Schnittstellenzeigers ist, der von IUnknown abgeleitet wird. Die Funktion ruft die IUnknown::Release-Methode der Schnittstelle auf und legt dann den Schnittstellenzeiger auf NULL fest.
Beispiele
Im folgenden Beispiel wird IUnknown_AtomicRelease verwendet, um den Stream freizugeben, sofern vorhanden. Wenn dies nicht der Fall ist, wird nichts ausgeführt.
void sample()
{
IStream *pstm = NULL;
CreateStreamOnHGlobal(NULL, TRUE, &pstm);
IUnknown_AtomicRelease((void**)&pstm);
// At this point, pstm is NULL
}
Anforderungen
Unterstützte Mindestversion (Client) | Windows 2000 Professional, Windows XP [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows 2000 Server, Windows Server 2003 [nur Desktop-Apps] |
Zielplattform | Windows |
Kopfzeile | shlwapi.h |
DLL | Shlwapi.dll (Version 5.0 oder höher) |