IUnknown_AtomicRelease, fonction (shlwapi.h)

Article
08/26/2023

Libère un pointeur COM (Component Object Model) et lui affecte la valeur NULL.

Syntaxe

void IUnknown_AtomicRelease(
  [in, out, optional] void **ppunk
);

Paramètres

[in, out, optional] ppunk

Type : void**

Adresse d’un pointeur vers une interface COM.

Valeur de retour

None

Remarques

Si ppunk pointe vers un pointeur NULL , aucune opération n’est effectuée. Sinon, ppunk est supposé être l’adresse d’un pointeur d’interface COM, dérivé de IUnknown. La fonction appelle la méthode IUnknown::Release de l’interface, puis définit le pointeur d’interface sur NULL.

Exemples

L’exemple suivant utilise IUnknown_AtomicRelease pour libérer le flux, s’il existe. Si ce n’est pas le cas, elle ne fait rien.

void sample()
{
    IStream *pstm = NULL;
    CreateStreamOnHGlobal(NULL, TRUE, &pstm);
    
    IUnknown_AtomicRelease((void**)&pstm);
    
    // At this point, pstm is NULL
}

Configuration requise


Client minimal pris en charge	Windows 2000 Professionnel, Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server, Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shlwapi.h
DLL	Shlwapi.dll (version 5.0 ou ultérieure)

Partager via