INDConnector Interface
Use to connect to a remote peer.
The INDAdapter::CreateConnector method returns this interface.
Members
The INDConnector interface inherits from INDOverlapped. INDConnector also defines the following types of members:
- Methods
Methods
The INDConnector interface defines the following methods.
| Method | Description |
|---|---|
| CreateEndpoint | Creates an endpoint to use for data transfers. |
| Connect | Connects the endpoint to a listening peer. |
| CompleteConnect | Completes the connection request initiated by a previous call to the Connect method. |
| Accept | Accepts a pending connection request and assigns an endpoint to use in the data exchange. |
| Reject | Rejects a pending connection request. |
| GetConnectionData | Retrieves the private data that the peer sends when it accepts or rejects the connection request. |
| GetLocalAddress | Retrieves the address of the local Network Direct adapter. |
| GetPeerAddress | Retrieves the address of the peer's Network Direct adapter. |
| NotifyDisconnect | Notifies the caller that an established connection was disconnected. |
| Disconnect | Disconnects the endpoint from the peer. |
Remarks
The connecting peer uses the endpoint that it passes to Connect to specify the inbound and outbound read limits that it wants to use. The remote peer gets the connecting peer's limits by calling the GetConnectionData method, and uses them (or optionally reduces them) to create its endpoint. When the remote peer calls Accept, Accept transfers the (potentially updated) limits back to the connecting peer. The connecting peer retrieves the limits by calling the GetConnectionData method. The connecting peer can accept the limits and call the CompleteConnect method to complete the connection or call the Reject method to reject the connection. When the connecting peer calls CompleteConnect, the limit values in its endpoint are updated with the new limits.
This interface inherits the CancelOverlappedRequestsmethod from the INDOverlapped interface. When you call CancelOverlappedRequests for the INDConnector interface, the method cancels all outstanding operations that were initiated on the INDConnector object and that took an OVERLAPPED structure as input. These operations include the following methods for the INDConnector interface:
Requirements
Product |
Microsoft Message Passing Interface (MS-MPI) |
Header |
Ndspi.h |
Send comments about this topic to Microsoft
Build date: 7/2/2010