PreviousNext

endpoint delete

Deletes the specified endpoints from the local endpoint map database. The syntax is:

endpoint delete -interface interface_id -binding protocol_sequence_list
[-object object_uuid_list]

Options

-interface interface_id
This required option declares the interface identifier of a single RPC interface.

See Data Structures for the format of the interface identifier.

-binding protocol_sequence_list
This required option declares a list of one or more protocol sequences (RPC string bindings) for the endpoint delete operation.

See Data Structures for the format of a protocol sequence.

-object object_uuid_list
Declares the UUID of an object. Each endpoint delete operation accepts a list of up to 32 object UUIDs. The UUID is a hexadecimal string. See Data Structures for the format of the object UUID.

The endpoint delete operation deletes the specified endpoints from the endpoint map database. This command takes no arguments. Requires the -interface and -binding options; and accepts the -object option. The values of all but the -interface option may be lists. If the mappings do not exist, an error is generated.

This command creates a cross product from the -interface, -binding and -object options and removes each element in the cross product from the local endpoint map. See the endpoint create command for more details.

This command returns an empty string on success.

Examples
The following command removes an endpoint object from the local host's endpoint map. This example uses backslashes (\) to escape the brackets. Otherwise dcecp interprets the brackets as enclosing another command.

dcecp> endpoint delete -interface 458ffcbe-98c1-11cd-bd93-0000c08adf56,1.0 \
>
-binding ncacn_ip_tcp:130.105.1.227\[1072\]

This example uses the dcecp string syntax to delete an endpoint from the local host's endpoint map.

dcecp> endpoint delete -interface {458ffcbe-98c1-11cd-bd93-0000c08adf56,1.0} \
>
-binding {ncacn_ip_tcp 130.105.1.227 1072}
dcecp>