Accès aux pointeurs opaques

Les clients peuvent accéder aux informations stockées dans les destinations à l’aide de pointeurs opaques. Pour utiliser le stockage, le client doit d’abord appeler RtmGetOpaqueInformationPointer pour obtenir le pointeur. Chaque fois qu’une modification des informations est nécessaire, le client doit d’abord verrouiller la destination en appelant RtmLockDestination avec le paramètre LockDest défini sur TRUE. Une fois la destination verrouillée, le client peut apporter les modifications nécessaires. La destination peut être déverrouillée à l’aide d’un autre appel à RtmLockDestination avec le paramètre LockDest défini sur FALSE.

La fonction RtmLockDestination permet également à un client d’utiliser un verrou de lecture ou un verrou d’écriture, à l’aide du paramètre Exclusive . Un client doit utiliser le verrou d’écriture uniquement lorsqu’il apporte des modifications aux informations conservées à l’aide du pointeur opaque. Les clients peuvent utiliser le verrou de lecture pour afficher les informations opaques du pointeur stockées dans une destination.

Pour obtenir un exemple de code qui montre comment utiliser ces fonctions, consultez Accéder au pointeur opaque dans une destination.