Fonction RpcObjectInqType (rpcdce.h)

  • Article

La fonction RpcObjectInqType retourne le type d’un objet.

Syntaxe

RPC_STATUS RpcObjectInqType(
  UUID *ObjUuid,
  UUID *TypeUuid
);

Paramètres

ObjUuid

Pointeur vers l’objet UUID dont le type UUID associé est retourné.

TypeUuid

Retourne un pointeur vers le type UUID du paramètre ObjUuid .

Spécifiez une valeur de paramètre NULL pour empêcher le retour d’un UUID de type. De cette façon, une application peut déterminer (à partir de la status retournée) si ObjUuid est inscrit sans spécifier de variable UUID de type de sortie.

Valeur retournée

Valeur Signification
RPC_S_OK
 L’appel a réussi.
RPC_S_OBJECT_NOT_FOUND
 Objet introuvable.
 
Note Pour obtenir la liste des codes d’erreur valides, consultez Valeurs de retour RPC.
 

Remarques

Une application serveur appelle RpcObjectInqType pour obtenir le type UUID d’un objet. Si l’objet a été inscrit auprès de la bibliothèque d’exécution RPC à l’aide de la fonction RpcObjectSetType , le type inscrit est retourné.

Si vous le souhaitez, une application peut gérer en privé une inscription d’objet/type. Dans ce cas, si l’application a fourni une fonction d’interrogation d’objet (voir sous RpcObjectSetInqFn). La bibliothèque d’exécution RPC utilise cette fonction pour déterminer le type d’un objet.

La fonction RpcObjectInqType obtient le type UUID comme décrit dans le tableau suivant.

UUID d’objet
 
inscrit		 Fonction d’interrogation
 
inscrit		 Renvoie
 
value
Oui ( RpcObjectSetType) Ignoré UUID de type inscrit de l’objet.
No Oui ( RpcObjectSetInqFn) Type UUID retourné par la fonction d’interrogation.
Non Non UUID nil.
 
 

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge Windows 2000 Server [applications de bureau uniquement]
Plateforme cible Windows
En-tête rpcdce.h (inclure Rpc.h)
Bibliothèque Rpcrt4.lib
DLL Rpcrt4.dll

Voir aussi

RpcObjectSetInqFn

RpcObjectSetType