Welcome to
www.tdxlibrary.org
Home of the
the TDx_Library...
"RAD DirectX"
for
C++ Builder
...
- Description
The CreateAddress method will create a TDx_Play address from a network address specific to a service provider.
The resulting address identifies the service provider and includes a network address the service provider can understand.
TDx_PlayLobby::CreateCompoundAddress() can be used to create addresses with more than one data chunk and is generally much more useful.
Error values that can be generated are:
DPERR_BUFFERTOOSMALL
DPERR_INVALIDPARAMS
- Parameters
SP
The SP parameter identifies the service provider.
DataType
The DataType parameter identifies the type of network address being used.
The predefined address types are:
DPAID_Comport
DPAID_INet
DPAID_INetW
DPAID_INetPort
DPAID_LobbyProvider
DPAID_Modem
DPAID_ModemW
DPAID_Phone
DPAID_PhoneW
DPAID_ServiceProvider
DPAID_TotalSize
Data
The Data parameter references the network address being used to create the TDx_Play address.
The data referenced and how it is interpreted depends on the type specified in DataType.
DPAID_ComPort
A TDPComportAddress component defining COM port settings.
DPAID_INet
An ANSI representation of an IP or domain address.
For Example: "220.150.10.102" or "game.com".
Using an empty string ("") causes the Internet TCP/IP connection service provider enumerate active sessions on the specified network address or broadcast on the subnet.
The DataSize must include the terminator.
DPAID_INetW
A unicode representation of an IP or domain address.
For Example: "220.150.10.102" or "game.com".
Using an empty string ("") causes the Internet TCP/IP connection service provider enumerate active sessions on the specified network address or broadcast on the subnet.
The DataSize must include the terminator.
DPAID_INetPort
An integer specifying which port number to use for communications.
DPAID_LobbyProvider
A 16-byte GUID identifying the lobby provider the address applies to.
DPAID_Modem
A NULL terminated ANSI value specifying which modem to use.
Available modems can be determined with TDx_Play::GetPlayerAddress().
The DataSize must include the terminator.
DPAID_ModemW
A NULL terminated unicode value specifying which modem to use.
Available modems can be determined with TDx_Play::GetPlayerAddress().
The DataSize must include the terminator.
DPAID_Phone
An ANSI value defining a phone number.
The modem service provider will call this number when TDx_Play::EnumSessions() is called.
If no modem is specified, the first available modem will be used.
The DataSize must include the terminator.
DPAID_PhoneW
A unicode value defining a phone number.
The modem service provider will call this number when TDx_Play::EnumSessions() is called.
If no modem is specified, the first available modem will be used.
The DataSize must include the terminator.
DPAID_ServiceProvider
A 16-byte GUID identifying the service provider the address applies to.
DPAID_TotalSize
A dword holding the size of the internal DPADDRESS structure.
DataSize
The DataSize parameter defines the size, in bytes, of the network address in the Data parameter.
Address
The Address parameter will reference the newly created address if this method returns successfully.
Set NULL to retrieve the required buffer size in the AddressSize parameter.
AddressSize
The AddressSize parameter references the size, in bytes, of the Address buffer
Before the call, set this to the size of the Address buffer.
After the call, it will indicate how many bytes were written to the Address buffer.
If the Address buffer was too small, this parameter will be set to the required size and DPERR_BUFFERTOOSMALL returned.
- See Also
- Top
TDx_Play_Library v2.00 Component Reference
|
|
|
[ TDx_PlayLobby::CreateAddress() ] [ next: CreateCompoundAddress() ] [ prev: Create() ] public:
virtual bool __fastcall CreateAddress( REFGUID pSP, REFGUID pDataType, const void* pData, dword pDataSize, void* pAddress, dword* pAddressSize );
TDX_PLAYLOBBY::CREATEADDRESS()
[ component method ]
If you would like to submit additions or improvements to this page, click: darren_john_dwyer@hotmail.com. |
|