The RRouterInterfaceTransportRemove method<267> is used to remove an existing transport (IPX, IPv4, or IPv6) from the RRAS server on an interface.
DWORD RRouterInterfaceTransportRemove( [in] DIM_HANDLE hDimServer, [in] DWORD hInterface, [in] DWORD dwTransportId );
hDimServer: A handle to the RRASM server where the call is to be executed, see section 3.1.3.
hInterface: A unique identifier of an interface. This can be obtained from RRouterInterfaceCreate (section 3.1.4.13) or RRouterInterfaceGetHandle (section 3.1.4.12). Because the RRASM server does not maintain the interface handles, the RRAS server SHOULD check and ensure that this handle represents a valid interface handle.
dwTransportId: Specifies the transport (IPX, IPv4, or IPv6). It MUST be one of the following values.<268> Otherwise an error other than those in the returned values table is returned.
|
Value |
Meaning |
|---|---|
|
PID_IPX 0x0000002B |
IPX protocol |
|
PID_IP 0x00000021 |
IPv4 protocol |
|
PID_IPV6 0x00000057 |
IPv6 protocol |
Return Values: A 32-bit, unsigned integer value that indicates return status. A return value ERROR_SUCCESS (0x00000000) indicates that the operation was completed successfully; otherwise, the return value contains an error code, as specified in [MS-ERREF] or in section 2.2.4. All values that are not in the table that follows MUST be treated the same by the RRASM client.
The return value is one of the following error codes. All other values MUST be treated the same.
|
Return value/code |
Description |
|---|---|
|
ERROR_SUCCESS 0x00000000 |
The call was successful. |
|
ERROR_ACCESS_DENIED 0x00000005 |
The calling application does not have sufficient privileges, as specified in section 2.1.1.1. |
The opnum field value for this method is 16.
When processing this call, the RRASM server MUST do the following:
Validate, as specified in section 2.1.1.1, whether this method was called by a client that has access to the method. If the client does not have access, then return error ERROR_ACCESS_DENIED (0x00000005).
If dwTransportId is not specified in the SupportedTransportsList, return an error other than one of the errors specified in the preceding table.
Call the abstract interface Invoke DIMSVC method specifying the operation and the parameters to enable RRAS server to perform the required management task.
Return any error status that the RRAS server returns as a result of its processing. Otherwise return ERROR_SUCCESS (0x00000000).
No exceptions are thrown beyond those thrown by the underlying RPC protocol [MS-RPCE].