Muokkaa

Jaa

DbgRpc Command-Line Options

  • Artikkeli

The DbgRpc command line must always contain exactly one of the -l, -e, -t, -c, or -a switches. The options following these switches depend on the switch used. The -s, -p, and -r options can be used with any other options.

 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 -?

Parameters

-s Server
Allows DbgRpc to view information from a remote machine. The server name should not be preceded by slash marks. For more information about using DbgRpc remotely, see Using the DbgRpc Tool.

-p ProtSeq
Specifies the remote transport to be used. The possible values of ProtSeq are ncacn_ip_tcp (TCP protocol) and ncacn_np (named pipe protocol). TCP protocol is recommended. For more information about using DbgRpc remotely, see Using the DbgRpc Tool.

-r Radix
Specifies the radix to be used for the command parameters. The default is base 16. If the -r parameter is used, it should be placed first on the line, since it only affects parameters listed after itself. It does not affect the output of the DbgRpc tool.

-l
Displays RPC state information for the specified cell. For an example, see Get RPC Cell Information.

ProcessID
Specifies the process ID (PID) of a process. When the -l option is being used, this should be the process whose server contains the desired cell. When the -t option is being used, this should be the process containing the desired thread. When the -c or -a options are being used, this parameter is optional; it should be the server process that owns the calls you wish to display.

CellID1.CellID2
Specifies the number of the cell to be displayed.

-e
Searches the system's RPC state information for endpoint information. For an example, see Get RPC Endpoint Information.

EndpointName
Specifies the number of the endpoint to be displayed. If omitted, the endpoints for all processes on the system are displayed.

-t
Searches the system's RPC state information for thread information. For an example, see Get RPC Thread Information.

ThreadID
Specifies the thread ID of the thread to be displayed. If omitted, all threads in the specified process will be displayed.

-c
Searches the system's RPC state information for server-side call (SCALL) information. For an example, see Get RPC Call Information.

-a
Searches the system's RPC state information for client call (CCALL) information. For an example, see Get RPC Client Call Information. This option requires full RPC state information.

CallID
Specifies the call ID. This parameter is optional; include it only if you want to display calls matching a specific CallID value.

IfStart
Specifies the first DWORD of the interface's universally unique identifier (UUID) on which the call was made. This parameter is optional; include it only if you want to display calls matching a specific IfStart value.

ProcNum
Specifies the procedure number of this call. (The RPC Run-Time identifies individual routines from an interface by numbering them by position in the IDL file -- the first routine in the interface is 0, the second 1, and so on.) This parameter is optional; include it only if you want to display calls matching a specific ProcNum value.

Additional Information

For more information about debugging Microsoft Remote Procedure Call (RPC), see RPC Debugging.

For general information about RPC security and guidelines for usage, see Writing a Secure RPC Client or Server.