RpcMgmtEpUnregister
The RpcMgmtEpUnregister
function removes server address information from an endpoint map.
This function
is supported by both 32-bit platforms Windows NT and Windows 95.
#include <rpc.h>
RPC_STATUS RPC_ENTRY RpcMgmtEpUnregister(
RPC_BINDING_HANDLE EpBinding, |
|
RPC_IF_ID * IfId, |
|
RPC_BINDING_HANDLE Binding, |
|
UUID *
ObjectUuid |
|
); |
|
Parameters
EpBinding
Specifies the
host whose endpoint map elements are to be unregistered. To remove elements
from the same host as the calling application, the application specifies NULL.
To remove elements from another host, the application specifies a server
binding handle for any server residing on that host. Note that the application
can specify the same binding handle it is using to make other remote procedure
calls.
IfId
Specifies the
interface identifier to remove from the endpoint map.
Binding
Specifies the
binding handle to remove.
ObjectUuid
Specifies the
optional object UUID to remove. The value NULL indicates there is no object
UUID to remove.
Remarks
The RpcMgmtEpUnregister
routine unregisters an element from the endpoint map. A management program
calls this routine to remove addresses of servers that are no longer available,
or to remove addresses of servers that support objects that are no longered
offered.
The EpBinding
parameter must be a full binding. The object UUID associated with the EpBinding
parameter must be a nil UUID. Specifying a non-nil UUID causes the routine to
fail with the status code EPT_S_CANT_PERFORM_OP. Other than the host
information and object UUID, all information in this argument is ignored.
An
application calls RpcMgmtEpEltInqNext to view local endpoint map
elements. The application can then remove the elements using RpcMgmtEpUnregister.
Note Use this
routine with caution. Removing elements from the local endpoint map may make
servers unavailable to client applications that do not already have a fully
bound binding handle to the server.
Return Values
Value |
Meaning |
RPC_S_OK |
Success |
RPC_S_CANT_PERFORM_OP |
Cannot
perform the requested operation |
See Also