NDceRpc.Microsoft

Provides a connection-based wrapper around the RPC client

Disconnects the client and frees any resources.

Connects the client; however, this is a soft-connection and validation of the connection will not take place until the first call is attempted.

Adds authentication information to the client, use the static Self to authenticate as the currently logged on Windows user.

Adds authentication information to the client, use the static Self to authenticate as the currently logged on Windows user. This overload allows you to specify the privacy level and authentication types to try. Normally these default to RPC_C_PROTECT_LEVEL_PKT_PRIVACY, and both RPC_C_AUTHN_GSS_NEGOTIATE or RPC_C_AUTHN_WINNT if that fails. If credentials is null, or is the Anonymous user, RPC_C_PROTECT_LEVEL_DEFAULT and RPC_C_AUTHN_NONE are used instead.

The protocol that was provided to the constructor

Returns a constant NetworkCredential that represents the Anonymous user

Returns a constant NetworkCredential that represents the current Windows user

Is thread safe.

Client side transport interfaces

The interface Id the client is connected to

Connects to the provided server interface with the given protocol and server:endpoint

Sends a message as an array of bytes and retrieves the response from the server, if AuthenticateAs() has not been called, the client will authenticate as Anonymous.

The delegate format for the OnExecute event

Provides server-side services for RPC

The max limit of in-flight calls

Disposes of the server and stops listening if the server is currently listening

Used to ensure that the server is listening with a specific protocol type.

Adds a type of authentication sequence that will be allowed for RPC connections to this process.

Starts the RPC listener for this instance,

Stops listening for this instance.

Server side transport interface.

The interface Id the service is using

Constructs an RPC server for the given interface guid, the guid is used to identify multiple rpc servers/services within a single process.

Can be over-ridden in a derived class to handle the incomming RPC request, or you can subscribe to the OnExecute event.

Allows a single subscription to this event to handle incomming requests rather than deriving from and overriding the Execute call.

provides a set of runtime validations for inputs

Verifies that the condition is true and if it fails constructs the specified type of exception and throws.

Verifies that the condition is true and if it fails constructs the specified type of exception with any arguments provided and throws.

Verifies that value is not null and returns the value or throws ArgumentNullException

Asserts that the argument is set to RPC_STATUS.RPC_S_OK or throws a new exception.

The enumerated type describes the asynchronous notification events that an RPC application can receive.

The remote procedure call has completely executed.

Keeps trying to establish communications forever. Tries the minimum amount of time for the network protocol being used. This value favors response time over correctness in determining whether the server is running. Tries an average amount of time for the network protocol being used. This value gives correctness in determining whether a server is running and gives response time equal weight. This is the default value. Tries the longest amount of time for the network protocol being used. This value favors correctness in determining whether a server is running over response time.

No notification is specified; is not initialized.

The notification mechanism is a Windows system message.

The notification mechanism is a function callback.

The structure holds the state of an asynchronous remote procedure call. Used to wait for, query, reply to, or cancel asynchronous calls.

Size of this structure, in bytes. The environment sets this member when is called. Do not modify this member.

The run-time environment sets this member when is called. Do not modify this member.

Reserved for use by the stubs. Do not use this member.

Use this member for any application-specific information that you want to keep track of in this structure.

Reserved for use by the RPC run-time environment. Do not use this member.

Reserved for compatibility with future versions, if any. Do not use this member.

The authorization service constants represent the authorization services passed to various run-time functions.

Server performs no authorization.

The function is a prototype for a function that facilitates replacement of the default object UUID to type UUID mapping.

The stub received bad data.

http://msdn.microsoft.com/en-us/library/windows/desktop/aa373954.aspx

When this interface flag is registered, the RPC runtime invokes the registered security callback for all calls, regardless of identity, protocol sequence, or authentication level of the client. This flag is allowed only when a security callback is registered. Note This flag is available starting with Windows XP with SP2 and Windows Server 2003 with SP1. When this flag is not set, RPC automatically filters all unauthenticated calls before they reach the security callback.

Defines the various types of protocols that are supported by Win32 RPC. NCA stands for Network Computing Architecture

Connection-oriented NetBIOS over Transmission Control Protocol (TCP) Client only: MS-DOS, Windows 3.x Client and Server: Windows Server 2003, Windows XP, Windows 2000, Windows NT

Connection-oriented NetBIOS over Internet Packet Exchange (IPX) Client only: MS-DOS, Windows 3.x Client and Server: Windows Server 2003, Windows XP, Windows 2000, Windows NT

Connection-oriented NetBIOS Enhanced User Interface (NetBEUI) Client only: MS-DOS, Windows 3.x Client and Server: Windows Server 2003, Windows XP, Windows 2000, Windows NT, Windows Me, Windows 98, Windows 95

Connection-oriented Transmission Control Protocol/Internet Protocol (TCP/IP) Client only: MS-DOS, Windows 3.x, and Apple Macintosh Client and Server: Windows Server 2003, Windows XP, Windows 2000, Windows NT, Windows Me, Windows 98, Windows 95

Connection-oriented named pipes Client only: MS-DOS, Windows 3.x, Windows 95 Client and Server: Windows Server 2003, Windows XP, Windows 2000, Windows NT

Connection-oriented Sequenced Packet Exchange (SPX) Client only: MS-DOS, Windows 3.x Client and Server: Windows Server 2003, Windows XP, Windows 2000, Windows NT, Windows Me, Windows 98, Windows 95

Connection-oriented DECnet transport Client only: MS-DOS, Windows 3.x

Connection-oriented AppleTalk DSP Client: Apple Macintosh Server: Windows Server 2003, Windows XP, Windows 2000, Windows NT

Connection-oriented Vines scalable parallel processing (SPP) transport Client only: MS-DOS, Windows 3.x Client and Server: Windows Server 2003, Windows XP, Windows 2000, Windows NT

Datagram (connectionless) User Datagram Protocol/Internet Protocol (UDP/IP) Client only: MS-DOS, Windows 3.x Client and Server: Windows Server 2003, Windows XP, Windows 2000, Windows NT

Datagram (connectionless) IPX Client only: MS-DOS, Windows 3.x Client and Server: Windows Server 2003, Windows XP, Windows 2000, Windows NT

Datagram (connectionless) over the Microsoft Message Queue Server (MSMQ) Client only: Windows Me/98/95 Client and Server: Windows Server 2003, Windows XP, Windows 2000, Windows NT Server 4.0 with SP3 and later

Connection-oriented TCP/IP using Microsoft Internet Information Server as HTTP proxy Client only: Windows Me/98/95 Client and Server: Windows Server 2003, Windows XP, Windows 2000

Local procedure call Client and Server: Windows Server 2003, Windows XP, Windows 2000, Windows NT, Windows Me, Windows 98, Windows 95

A strongly-typed resource class, for looking up localized strings, etc.

Returns the cached ResourceManager instance used by this class.

Overrides the current thread's CurrentUICulture property for all resource lookups using this strongly typed resource class.

Looks up a localized string similar to Unspecified rpc error.

This option is ignored for

The function registers an object-inquiry function. A null value turns off a previously registered object-inquiry function.

The function sets the object UUID value in a binding handle.

Server binding into which the ObjectUuid is set. Pointer to the UUID of the object serviced by the server specified in the Binding parameter. ObjectUuid is a unique identifier of an object to which a remote procedure call can be made.

The RpcObjectSetType function assigns the type of an object.

Pointer to an object UUID to associate with the type UUID in the TypeUuid parameter. Pointer to the type UUID of the ObjUuid parameter. Specify a parameter value of NULL or a nil UUID to reset the object type to the default association of object UUID/nil-type UUID.

The RpcBindingReset function resets a binding handle so that the host is specified but the server on that host is unspecified.

Server binding handle to reset. The call succeeded. The binding handle was invalid. This was the wrong kind of binding for the operation.

Validates the format of the string binding handle and converts it to a binding handle. Connection is not done here either.

The function sets a binding handle's authentication and authorization information.

Authentication service to use. Authorization service implemented by the server for the interface of interest.

Returns a pointer to a handle to the privileged information for the client application that made the remote procedure call on the ClientBinding binding handle. For ncalrpc calls, Privs contains a string with the client's principal name. Return Type: RPC_STATUS->int IfSpec: RPC_IF_HANDLE->void* MgrTypeUuid: UUID* MgrEpv: void* Flags: unsigned int MaxCalls: unsigned int IfCallback: RPC_IF_CALLBACK_FN*

IfSpec: RPC_IF_HANDLE->void* MgrTypeUuid: UUID* MgrEpv: void* Flags: unsigned int MaxCalls: unsigned int MaxRpcSize: unsigned int IfCallbackFn: RPC_IF_CALLBACK_FN*

The function returns the message text for a status code.

Returns the text corresponding to the error code. Status code to convert to a text string. Return Type: RPC_STATUS->int InterfaceUuid: RPC_IF_HANDLE->void* Context: void*

Creates a composite name with the format and arguments specified

Delegate fired inside lock if this is the first Increment() call on the name provided

Delegate fired inside lock if the Decrement() count reaches zero

An interface that provide contextual information about the client within an Rpc server call

Returns a disposable context that is used to impersonate the calling user

Returns true if the caller is using LRPC

Returns a most random set of bytes, undocumented Win32 value.

Defines the type of the procol being used in the communication, unavailable on Windows XP

Returns the packet protection level of the communications

Returns the authentication level of the connection

Returns the ProcessId of the LRPC caller, may not be valid on all platforms

Returns true if the caller has authenticated as a user

Returns the client user name if authenticated, not available on WinXP

Returns the identity of the client user or Anonymous if unauthenticated

Returns true if already impersonating the caller

The authentication service constants represent the authentication services passed to various run-time functions. The following constants are valid values for the AuthnSvc parameter. The authentication type to be used for connection, GSS_NEGOTIATE / WINNT are the most common. Be aware that GSS_NEGOTIATE is not available unless the machine is a member of a domain that is not running WinNT (or in legacy mode).

Specify RPC_C_AUTHN_NONE to turn off authentication for remote procedure calls made over a binding handle. When you specify RPC_C_AUTHN_DEFAULT, the RPC run-time library uses the RPC_C_AUTHN_WINNT authentication service for remote procedure calls made using the binding handle.

No authentication.

WIN32 RPC Error Codes

The binding handle is not the correct type.

The binding handle is invalid.

The object universal unique identifier (UUID) has already been registered.

The string is too long.

The object universal unique identifier (UUID) is the nil UUID.

Hosts native server interfaces provided by unmanaged code as pointer.

Exception class: RpcException : System.ComponentModel.Win32Exception Unspecified rpc error

Serialization constructor

Unspecified rpc error

if(condition == false) throws Unspecified rpc error

Exception class: RpcException : System.ComponentModel.Win32Exception Unspecified rpc error

Returns the RPC Error as an enumeration

The authentication-level constants represent authentication levels passed to various run-time functions. These levels are listed in order of increasing authentication. Each new level adds to the authentication provided by the previous level. If the RPC run-time library does not support the specified level, it automatically upgrades to the next higher supported level. The protection level of the communications, is the default for authenticated communications.

Regardless of the value specified by the constant, ncalrpc always uses .

Performs no authentication

Defines the type of protocol the client is connected with

TCP, UDP, IPX over TCP, etc

Named Pipes

LPRC / Local RPC

HTTP / IIS integrated

Pointer to first

Handle to the structure containing the client's authentication and authorization credentials appropriate for the selected authentication and authorization service.