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
);
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.
Value | Meaning |
---|---|
RPC_S_OK | Success |
RPC_S_CANT_PERFORM_OP | Cannot perform the requested operation |
Windows NT: Yes
Windows CE: Unsupported.
Header: Declared in rpcdce.h.
Import Library: Link with rpcrt4.lib.
RpcEpRegister, RpcEpUnregister