»
Symbian OS v9.1 »
Symbian OS reference »
C++ component reference »
Comms infras ESOCK »
RServiceResolver
Location:
ES_SOCK.H
Link against: esock.lib
class RServiceResolver : public RSubSessionBase;
Description
Provides an interface to resolver service names and ports.
Derivation
RSubSessionBase - Client-side handle to a sub-sessionRServiceResolver - Provides an interface to resolver service names and ports
Members
Defined in RServiceResolver:
Cancel(), Close(), GetByName(), GetByName(), GetByNumber(), GetByNumber(), Open(), RegisterService(), RegisterService(), RemoveService(), RemoveService()
Inherited from RSubSessionBase:
CloseSubSession(),
CreateAutoCloseSubSession(),
CreateSubSession(),
Send(),
SendReceive(),
Session(),
SubSessionHandle()
Member functions
IMPORT_C TInt Open(RSocketServ &aSocketServer, TUint anAddrFamily, TUint sockType, TUint aProtocol);
Description
set up the sub session - unlike name resolvers and net databases, services can be socket type specific. Opens a service resolver service.
Unlike name resolvers (RHostResolver) and net databases (RNetDatabase), services can be socket type specific.
Parameters
RSocketServ &aSocketServer |
The socket server session. |
TUint anAddrFamily |
A constant identifying the protocol family. |
TUint sockType |
A constant that identifies the socket type. |
TUint aProtocol |
A constant that identifies the protocol that provides the service. |
|
Return value
TInt
|
KErrNone if successful otherwise another of the system-wide error codes. |
|
IMPORT_C void GetByName(const TDesC &aName, TPortNum &aPort, TRequestStatus &aStatus);
Description
Gets a service by name asynchronously.
Parameters
const TDesC &aName |
Name of the service to get. |
TPortNum &aPort |
On completion, the port associated with the service. |
TRequestStatus &aStatus |
On completion, KErrNone if successful otherwise another of the system-wide error codes. |
|
IMPORT_C TInt GetByName(const TDesC &aName, TPortNum &aPort);
Description
Get a service by name.
Parameters
const TDesC &aName |
Name of the service to get. |
TPortNum &aPort |
On return, the port associated with the service. |
|
Return value
TInt
|
KErrNone if successful otherwise another of the system-wide error codes. |
|
IMPORT_C void GetByNumber(const TUint aPort, TDes &aName, TRequestStatus &aStatus);
Description
Gets the name of the service asynchronously.
Parameters
const TUint aPort |
Port of the service. |
TDes &aName |
On completion, the name of the service. |
TRequestStatus &aStatus |
On completion, KErrNone if successful otherwise another of the system-wide error codes. |
|
IMPORT_C TInt GetByNumber(const TUint aPort, TDes &aName);
Description
Gets the name of the service
Parameters
const TUint aPort |
Port of the service. |
TDes &aName |
On return, the name of the service. |
|
Return value
TInt
|
KErrNone if successful otherwise another of the system-wide error codes. |
|
| Capability: | NetworkControl | |
IMPORT_C void RegisterService(const TDesC &aName, const TUint &aPort, TRequestStatus &aStatus);
Description
Registers a new service asynchronously.
Parameters
const TDesC &aName |
Name of the service. |
const TUint &aPort |
Port of the service. |
TRequestStatus &aStatus |
On completion, KErrNone if successful otherwise another of the system-wide error codes. |
|
| Capability: | NetworkControl | |
IMPORT_C TInt RegisterService(const TDesC &aName, const TUint &aPort);
Description
Registers a new service.
Parameters
const TDesC &aName |
Name of the service. |
const TUint &aPort |
Port of the service. |
|
Return value
TInt
|
KErrNone if successful, otherwise another of the system-wide error codes. |
|
| Capability: | NetworkControl | |
IMPORT_C void RemoveService(const TDesC &aName, const TUint &aPort, TRequestStatus &aStatus);
Description
Removes a service asynchronously.
Parameters
const TDesC &aName |
Name of the service to remove. |
const TUint &aPort |
Port of the service to remove. |
TRequestStatus &aStatus |
On completion, KErrNone if successful otherwise another of the system-wide error codes. |
|
| Capability: | NetworkControl | |
IMPORT_C TInt RemoveService(const TDesC &aName, const TUint &aPort);
Description
Removes a service.
Parameters
const TDesC &aName |
Name of the service. |
const TUint &aPort |
Port of the service. |
|
Return value
TInt
|
KErrNone if successful otherwise another of the system-wide error codes. |
|
IMPORT_C void Close();
Description
Closes a service resolver service
If a service has been opened using Open(), then it should be closed using Close(). This will ensure all associated resources are released.
IMPORT_C void Cancel();
Description
Cancels any pending request.
![[Index]](../../../../_stock/btn_index_wt.gif){kind=small}
![[Spacer]](../../../../_stock/btn_spacer.gif){kind=small}
![[Previous]](../../../../_stock/btn_prev_wt.gif){kind=small}
![[Next]](../../../../_stock/btn_next_wt.gif){kind=small}
![[Previous]](../../../../_stock/btn_prev.gif){kind=small}
![[Top]](../../../../_stock/btn_top.gif)
![[Next]](../../../../_stock/btn_next.gif){kind=small}