Fonction RpcMgmtInqIfIds (rpcdce.h)

Article
08/25/2023

La fonction RpcMgmtInqIfIds retourne un vecteur contenant les identificateurs des interfaces proposées par le serveur.

Syntaxe

RPC_STATUS RpcMgmtInqIfIds(
  RPC_BINDING_HANDLE Binding,
  RPC_IF_ID_VECTOR   **IfIdVector
);

Paramètres

Binding

Pour recevoir des identificateurs d’interface sur une application distante, spécifiez un handle de liaison de serveur pour cette application. Pour recevoir des informations d’interface sur votre propre application, spécifiez la valeur NULL.

IfIdVector

Retourne l’adresse d’un vecteur d’identificateur d’interface.

Valeur retournée

Valeur	Signification
RPC_S_OK	L’appel a réussi.
RPC_S_INVALID_BINDING	Le handle de liaison n’était pas valide.
RPC_S_WRONG_KIND_OF_BINDING	Il s’agissait du mauvais type de liaison pour l’opération.

Note Pour obtenir la liste des codes d’erreur valides, consultez Valeurs de retour RPC.

Notes

Une application appelle la fonction RpcMgmtInqIfIds pour obtenir un vecteur d’identificateurs d’interface sur le serveur spécifié à partir de la bibliothèque d’exécution RPC.

La bibliothèque d’exécution RPC alloue de la mémoire pour le vecteur identificateur d’interface. L’application est chargée d’appeler la fonction RpcIfIdVectorFree pour libérer la mémoire utilisée par ce vecteur.

Le serveur doit être à l’écoute des appels de procédure distante pour que cette fonction réussisse. Si le serveur n’écoute pas, la fonction échoue.

Spécifications


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

RpcIfIdVectorFree

Partager via