Fonction RtmGetOpaqueInformationPointer (rtmv2.h)

  • Article

La fonction RtmGetOpaqueInformationPointer retourne un pointeur vers le champ d’informations opaque dans une destination réservée à ce client. Le pointeur permet au client de stocker des informations spécifiques au client avec la destination dans la table de routage.

Syntaxe

DWORD RtmGetOpaqueInformationPointer(
  [in]  RTM_ENTITY_HANDLE RtmRegHandle,
  [in]  RTM_DEST_HANDLE   DestHandle,
  [out] PVOID             *OpaqueInfoPointer
);

Paramètres

[in] RtmRegHandle

Gérez le client obtenu à partir d’un appel précédent à RtmRegisterEntity.

[in] DestHandle

Handle vers la destination.

[out] OpaqueInfoPointer

En entrée, OpaqueInfoPointer est un pointeur vers NULL.

À la sortie, OpaqueInfoPointer reçoit un pointeur vers le pointeur d’informations opaques. Si un client n’a pas réservé de pointeur opaque pendant l’inscription, ce paramètre reste inchangé.

Valeur retournée

Si la fonction réussit, la valeur de retour est NO_ERROR.

Si la fonction échoue, la valeur de retour est l’un des codes d’erreur suivants.

Valeur Signification
ERROR_INVALID_HANDLE
 Le handle n'est pas valide.
ERROR_NOT_FOUND
 Aucun pointeur opaque n’a été réservé par le client.
 
 

Notes

Pour obtenir un exemple de code utilisant cette fonction, consultez Accéder au pointeur opaque dans une destination.

Spécifications

   
Client minimal pris en charge Aucun pris en charge
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête rtmv2.h
Bibliothèque Rtm.lib
DLL Rtm.dll

Voir aussi

RtmLockDestination