RpcRaiseException
Use the RpcRaiseException
function to raise an exception. The RpcRaiseException function does not
return to the caller.
void RPC_ENTRY
RpcRaiseException (
RPC_STATUS Exception |
|
); |
|
Parameters
Exception
Specifies the
exception code for the exception. The following exception codes are defined:
Exception
code |
Description |
RPC_S_ACCESS_DENIED |
Access
denied |
RPC_S_ADDRESS_ERROR |
An addressing
error occurred in the RPC server |
RPC_S_ALREADY_LISTENING |
Server already
listening |
RPC_S_ALREADY_REGISTERED |
Object
already registered |
RPC_S_BINDING_HAS_NO_AUTH |
Binding has
no authentication |
RPC_S_BINDING_INCOMPLETE |
The binding
handle is a required parameter. |
RPC_S_BUFFER_TOO_SMALL |
Insufficient
buffer |
RPC_S_CALL_CANCELLED |
The remote
procedure call exceeded the cancel timeout and was canceled. |
RPC_S_CALL_FAILED |
Call failed |
RPC_S_CALL_FAILED_DNE |
Call failed
and did not execute |
RPC_S_CALL_IN_PROGRESS |
Call
already in progress for this thread |
RPC_S_CANNOT_SUPPORT |
Operation
is not supported |
RPC_S_CANT_CREATE_ENDPOINT |
Cannot
create endpoint |
RPC_S_COMM_FAILURE |
Unable to
communicate with the server |
RPC_S_DUPLICATE_ENDPOINT |
Endpoint
already exists |
RPC_S_ENTRY_ALREADY_EXISTS |
Name-service
entry already exists |
RPC_S_ENTRY_NOT_FOUND |
Name-service
entry not found |
RPC_S_FP_DIV_ZERO |
A
floating-point operation in the server caused a division by zero |
RPC_S_FP_OVERFLOW |
Floating-point
overflow has occurred in the RPC server |
RPC_S_FP_UNDERFLOW |
Floating-point
underflow has occurred in the server |
RPC_S_GROUP_MEMBER_NOT_FOUND |
Group
member not found |
RPC_S_INCOMPLETE_NAME |
Incomplete
name |
RPC_S_INTERFACE_NOT_FOUND |
Interface not
found |
RPC_S_INTERNAL_ERROR |
Internal error |
RPC_S_INVALID_ARG |
Invalid
argument |
RPC_S_INVALID_AUTH_IDENTITY |
Invalid
authentication |
RPC_S_INVALID_BINDING |
Invalid
binding handle |
RPC_S_INVALID_BOUND |
Invalid
bound |
RPC_S_INVALID_ENDPOINT_FORMAT |
Invalid
endpoint format |
RPC_S_INVALID_INQUIRY_CONTEXT |
Invalid
inquiry context |
RPC_S_INVALID_INQUIRY_TYPE |
Invalid
inquiry type |
RPC_S_INVALID_LEVEL |
Invalid
parameter |
RPC_S_INVALID_NAF_IF |
Invalid
network-address family ID |
RPC_S_INVALID_NAME_SYNTAX |
Invalid
name syntax |
RPC_S_INVALID_NET_ADDR |
Invalid
network address |
RPC_S_INVALID_NETWORK_OPTIONS |
Invalid
network options |
RPC_S_INVALID_OBJECT |
Invalid
object |
RPC_S_INVALID_RPC_PROTSEQ |
Invalid protocol
sequence |
RPC_S_INVALID_SECURIT_DESC |
Invalid
security descriptor |
RPC_S_INVALID_STRING_BINDING |
Invalid
string binding |
RPC_S_INVALID_STRING_UUID |
Invalid
string UUID |
RPC_S_INVALID_TAG |
Invalid tag |
RPC_S_INVALID_TIMEOUT |
Invalid
timeout value |
RPC_S_INVALID_VERS_OPTION |
Invalid
version option |
RPC_S_MAX_CALLS_TOO_SMALL |
Maximum-calls
value too small |
RPC_S_NAME_SERVICE_UNAVAILABLE |
Name
service unavailable |
RPC_S_NO_BINDINGS |
No bindings |
RPC_S_NO_CALL_ACTIVE |
No remote
procedure active in this thread |
RPC_S_NO_CONTEXT_AVAILABLE |
No security
context is available to perform impersonation |
RPC_S_NO_ENDPOINT_FOUND |
No endpoint
found |
RPC_S_NO_ENTRY_NAME |
No entry
name for binding |
RPC_S_NO_ENV_SETUP |
No
environment variable is set up |
RPC_S_NO_INTERFACES |
No
interfaces are registered |
RPC_S_NO_INTERFACES_EXPORTED |
No
interfaces have been exported |
RPC_S_NO_MORE_BINDINGS |
No more bindings |
RPC_NO_MORE_ELEMENTS |
There are
no more elements. |
RPC_S_NO_MORE_MEMBERS |
No more
members |
RPC_S_NO_NS_PRIVILEGE |
No
privilege for name-service operation |
RPC_S_NO_PRINC_NAME |
No
principal name is registered |
RPC_S_NO_PROTSEQS |
No
supported protocol sequences |
RPC_S_NO_PROTSEQS_REGISTERED |
No protocol
sequences registered |
RPC_S_NOT_ALL_OBJS_UNEXPORTED |
Not all
objects unexported |
RPC_S_NOT_CANCELLED |
The thread
is not canceled |
RPC_S_NOT_LISTENING |
Server not
listening |
RPC_S_NOT_RPC_ERROR |
The status
code requested is not valid |
RPC_S_NOTHING_TO_EXPORT |
Nothing to
export |
RPC_S_NOTHING_TO_UNEXPORT |
Nothing to
unexport |
RPC_S_OBJECT_NOT_FOUND |
Object not
found |
RPC_S_OK |
Success |
RPC_S_OUT_OF_MEMORY |
Out of
memory |
RPC_S_OUT_OF_RESOURCES |
Out of
resources |
RPC_S_OUT_OF_THREADS |
Out of
threads |
RPC_S_PROCNUM_OUT_OF_RANGE |
Procedure
number is out of range |
RPC_S_PROTOCOL_ERROR |
An RPC
protocol error occurred |
RPC_S_PROTSEQ_NOT_FOUND |
Protocol
sequence not found |
RPC_S_PROTSEQ_NOT_SUPPORTED |
Protocol
sequence not supported |
RPC_S_SERVER_OUT_OF_MEMORY |
Server out
of memory |
RPC_S_SERVER_TOO_BUSY |
Server too
busy |
RPC_S_SERVER_UNAVAILABLE |
The server
is unavailable |
RPC_S_STRING_TOO_LONG |
String too
long |
RPC_S_TYPE_ALREADY_REGISTERED |
Type UUID
already registered |
RPC_S_UNKNOWN_AUTHN_LEVEL |
Unknown
authentication level |
RPC_S_UNKNOWN_AUTHN_SERVICE |
Unknown
authentication service |
RPC_S_UNKNOWN_AUTHN_TYPE |
Unknown
authentication type |
RPC_S_UNKNOWN_IF |
Unknown
interface |
RPC_S_UNKNOWN_MGR_TYPE |
Unknown
manager type |
RPC_S_UNSUPPORTED-TRANS_SYN |
Transfer
syntax is not supported by the server |
RPC_S_UNSUPPORTED_NAME_SYNTAX |
Unsupported
name syntax |
RPC_S_UNSUPPORTED_TYPE |
Unsupported
UUID type |
RPC_S_UUID_LOCAL_ONLY |
The UUID
that is only valid for this computer has been allocated |
RPC_S_UUID_NO_ADDRESS |
No network
address is available to use to construct a UUID |
RPC_S_WRONG_KIND_OF_BINDING |
Wrong kind
of binding for operation |
RPC_S_ZERO_DIVIDE |
Attempt to
divide an integer by zero |
RPC_X_BAD_STUB_DATA |
The stub
received bad data |
RPC_X_BYTE_COUNT_TOO_SMALL |
Byte count
is too small |
RPC_X_ENUM_VALUE_OUT_OF
RANGE |
The
enumeration value is out of range |
RPC_X_ENUM_VALUE_TOO_LARGE |
The
enumeration value is out of range |
RPC_X_INVALID_BOUND |
Specified
bounds of an array inconsistent |
RPC_X_INVALID_TAG |
Discriminant
value does not match any case values; no default case |
RPC_X_NO_MEMORY |
Insufficient
memory available to set up necessary data structures |
RPC_X_NO_MORE_ENTRIES |
List of
servers available for AutoHandle binding has been exhausted |
RPC_X_NULL_REF_POINTER |
A null
reference pointer was passed to the stub |
RPC_X_SS_BAD_ES_VERSION |
The
operation for the serializing handle is not valid |
RPC_X_SS_CANNOT_GET_CALL_HANDLE |
The stub is
unable to get the remote procedure call handle |
RPC_X_SS_CHAR_TRANS_OPEN_FAIL |
File
designated by DCERPCCHARTRANS cannot be opened |
RPC_X_SS_CHAR_TRANS_SHORT_FILE |
File
containing character-translation table has fewer than 512 bytes |
RPC_X_SS_CONTEXT_DAMAGED |
Only raised
on caller side; UUID in in, out context handle changed during
call |
RPC_X_SS_CONTEXT_MISMATCH |
Only raised
on callee side; UUID in in handle does not correspond to any known
context |
RPC_X_SS_HANDLES_MISMATCH |
The binding
handles passed to a remote procedure call don t match |
RPC_X_SS_IN_NULL_CONTEXT |
Null
context handle passed in in parameter position |
RPC_X_SS_INVALID_BUFFER |
The buffer
is not valid for the operation. |
RPC_X_SS_WRONG_ES_VERSION |
The
software version is incorrect |
RPC_X_SS_WRONG_STUB_VERSION |
The stub
version is incorrect |
Remarks
The RpcRaiseException
routine raises an exception; this exception can then be handled by the
exception handler.
Return Values
No value is
returned.
See Also