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.

QuickInfo

  Windows NT: Yes
  Windows CE: Unsupported.
  Header: Declared in rpcdce.h.
  Import Library: Link with rpcrt4.lib.

See Also

RpcAbnormalTermination, RpcExcept, RpcFinally