TDI_ASSOCIATE_ADDRESS

Operation

TDI_ASSOCIATE_ADDRESS is a request message a client issues to indicate an associate address request.

Note TdiBuildAssociateAddress is the macro a client uses to fill in the IRP.

The client must make an associate address request after it has opened a connection with an open connection endpoint object request to the driver. It can close the connection or get or set information about the connection before making an associate address request.

After the client associates the connection endpoint with the address object, it can communicate with the driver to do anything except associate an address. It cannot make an associate address request again for the specific endpoint until it requests the driver to disassociate the address object (see TDI_DISASSOCIATE_ADDRESS).

Along with the request message, the TDI client must provide input and output buffers for the IRP as well as a status block structure the driver uses to write information about the request. These items are described below. For more information about the members of the IRP related to an associate address request, see TdiBuildAssociateAddress.

Input

None

Output

None

I/O Status Block

The driver fills in the Status member of the IRP with one of the following TDI status codes:

STATUS_CONNECTION_ESTABLISHED
STATUS_INVALID_CONNECTION
STATUS_INVALID_HANDLE
STATUS_SUCCESS

For more information about status codes, see Part II, Chapter 10.

See Also

TDI_DISASSOCIATE_ADDRESS, TdiBuildAssociateAddress