DbgRpc Command-Line Options

La ligne de commande DbgRpc doit toujours contenir exactement l’un des commutateurs -l, -e, -t, -c ou -a. Les options suivantes dépendent du commutateur utilisé. Les options -s, -p et -r peuvent être utilisées avec n’importe quelle autre option.

 dbgrpc [-s Server -p ProtSeq] [-r Radix] -l -P ProcessID -L CellID1.CellID2 

dbgrpc [-s Server -p ProtSeq] [-r Radix] -e [-E EndpointName] 

dbgrpc [-s Server -p ProtSeq] [-r Radix] -t -P ProcessID [-T ThreadID] 

dbgrpc [-s Server -p ProtSeq] [-r Radix] [-c|-a] [-C CallID] [-I IfStart] [-N ProcNum] [-P ProcessID] 

dbgrpc -? 

Paramètres

-sServer
Permet à DbgRpc d’afficher des informations à partir d’une machine distante. Le nom du serveur ne doit pas être précédé de barres obliques. Pour plus d’informations sur l’utilisation de DbgRpc à distance, consultez Utilisation de l’outil DbgRpc.

-pProtSeq
Spécifie le transport distant à utiliser. Les valeurs possibles de ProtSeq sont ncacn_ip_tcp (protocole TCP) et ncacn_np (protocole de canal nommé). Le protocole TCP est recommandé. Pour plus d’informations sur l’utilisation de DbgRpc à distance, consultez Utilisation de l’outil DbgRpc.

-rRadix
Spécifie le radix à utiliser pour les paramètres de commande. La valeur par défaut est base 16. Si le paramètre -r est utilisé, il doit être placé en premier sur la ligne, car il affecte uniquement les paramètres répertoriés après lui-même. Elle n’affecte pas la sortie de l’outil DbgRpc.

-l
Affiche les informations d’état RPC pour la cellule spécifiée. Pour obtenir un exemple, consultez Obtenir des informations de cellule RPC.

ProcessID
Spécifie l’ID de processus (PID) d’un processus. Lorsque l’option -l est utilisée, il doit s’agir du processus dont le serveur contient la cellule souhaitée. Lorsque l’option -t est utilisée, il doit s’agir du processus contenant le thread souhaité. Lorsque les options -c ou -a sont utilisées, ce paramètre est facultatif ; il doit s’agir du processus serveur propriétaire des appels que vous souhaitez afficher.

CellID1.CellID2
Spécifie le nombre de cellules à afficher.

-e
Recherche les informations d’état RPC du système pour obtenir des informations sur le point de terminaison. Pour obtenir un exemple, consultez Obtenir des informations sur le point de terminaison RPC.

EndpointName
Spécifie le nombre de points de terminaison à afficher. S’il est omis, les points de terminaison de tous les processus sur le système sont affichés.

-t
Recherche les informations d’état RPC du système pour obtenir des informations sur les threads. Pour obtenir un exemple, consultez Obtenir des informations sur les threads RPC.

ThreadID
Spécifie l’ID de thread du thread à afficher. S’il est omis, tous les threads du processus spécifié sont affichés.

-c
Recherche les informations d’état RPC du système pour obtenir des informations d’appel côté serveur (SCALL). Pour obtenir un exemple, consultez Obtenir des informations d’appel RPC.

-a
Recherche les informations d’état RPC du système pour obtenir des informations sur l’appel client (CCALL). Pour obtenir un exemple, consultez Obtenir des informations d’appel client RPC. Cette option nécessite des informations d’état RPC complètes.

callID
Spécifie l’ID d’appel. Ce paramètre est facultatif ; incluez-le uniquement si vous souhaitez afficher des appels correspondant à une valeur CallID spécifique.

IfStart
Spécifie le premier DWORD de l’identificateur UUID (Universally Unique Identifier) de l’interface sur lequel l’appel a été effectué. Ce paramètre est facultatif ; incluez-le uniquement si vous souhaitez afficher des appels correspondant à une valeur spécifique IfStart.

ProcNum
Spécifie le numéro de procédure de cet appel. (L'Run-Time RPC identifie les routines individuelles à partir d’une interface en les numérotant par position dans le fichier IDL : la première routine de l’interface est 0, la deuxième 1, et ainsi de suite.) Ce paramètre est facultatif ; incluez-le uniquement si vous souhaitez afficher des appels correspondant à une valeur de ProcNum spécifique.

Informations supplémentaires

Pour plus d’informations sur le débogage de l’appel de procédure distante Microsoft (RPC), consultez de débogage RPC.

Pour obtenir des informations générales sur la sécurité RPC et les instructions relatives à l’utilisation, consultez Écriture d’un client RPC sécurisé ou d’un serveur.