RpcRaiseException  7SMQ.RK

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

RpcAbnormalTermination, RpcExcept, RpcFinally