Accès aux pointeurs opaques

Les clients peuvent accéder aux informations stockées dans des 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 la modification nécessaire. 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 Exclusif . 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 de pointeur opaque stockées dans une destination.

Pour obtenir un exemple de code montrant comment utiliser ces fonctions, consultez Access the Opaque Pointer in a Destination.