SFBDNSConfig

Wrapper Class for the IDNSConfig interface.

#include <SFBDNSConfig.h.hpp>

class SFBDNSConfig : public SFBQuery;

SFMTYPEDEFWRAPPER(SFBDNSConfig)

Inheritance diagram

Version

BREW 2.0	BREW 2.1	BREW 3.1	BREW 4.0
X	X	O	O

Reference

BREW API IDNSConfig

Member

Public Functions
`SFCError`	GetServers( `INSockAddr*` servers , `UInt16Ptr` count ) Retrieve the current DNS server list.
static `SFBDNSConfigSmp`	NewInstance( `SFBDNSSmpConstRef` dns , `SFCErrorPtr` exception = null ) Create a new SFBDNSConfig instance.
static `SFBDNSConfigSmp`	NewInstance( `SFBDNSSmpConstRef` dns , `AEECLSID` id , `SFCErrorPtr` exception = null ) Create a new SFBDNSConfig instance.
`SFCError`	SetServers( `const INSockAddr*` servers , `UInt16` count ) This function is used to specify DNS server(s) to query.
`SFCError`	QueryInterface( `AEECLSID` clsid , `VoidHandle` handle ) (inherits from SFBQuery) Ask an object for another API contract from the object in question.
`SFCError`	QueryInterface( `AEECLSID` clsid , `SFBBaseSmpPtr` handle ) (inherits from SFBQuery) Ask an object for another API contract from the object in question.
`SFBBaseSmp`	QueryInterface( `AEECLSID` clsid ) (inherits from SFBQuery) Ask an object for another API contract from the object in question.
`Void`	Self( `AEECLSID` clsidReq , `SFBQuerySmpPtr` clone , `AEECLSID` clsidImp ) (inherits from SFBQuery) Helper macro for those implementing an object with a single interface.
`SFBQuerySmp`	Self( `AEECLSID` clsidReq , `AEECLSID` clsidImp ) (inherits from SFBQuery) Helper macro for those implementing an object with a single interface.

Protected Functions
static `SFBBaseSmp`	FactoryByCreate( `AEECLSID` id , `SFCErrorPtr` exception = null ) (inherits from SFBBase) Create the instance for the specified ClassID's interface.
static `SFBBaseSmp`	FactoryByQuery( `SFBQuerySmpConstRef` query , `AEECLSID` id , `SFCErrorPtr` exception = null ) (inherits from SFBBase) Create the instance for the specified ClassID's interface using the SFBQuery instance.

SFBDNSConfig::GetServers

Retrieve the current DNS server list.

[ public ]
SFCError GetServers(
    INSockAddr* servers   // pointer to an array of count server addresses
    UInt16Ptr count       // the max number of servers to may be written to servers
);

Return value

If succeeds: SFERR_NO_ERROR
servers is not a valid pointer: SFERR_INVALID_MEMORY
If failed: SFERR_FAILED

Reference

BREW API IDNSCONFIG_GetServers

SFBDNSConfig::NewInstance

Create a new SFBDNSConfig instance.

[ public, static ]
SFBDNSConfigSmp NewInstance(
    SFBDNSSmpConstRef dns          // SFBDNS instance
    SFCErrorPtr exception = null   // Error
);

[ public, static ]
SFBDNSConfigSmp NewInstance(
    SFBDNSSmpConstRef dns          // SFBDNS instance
    AEECLSID id                    // Class ID for the SFBDNS instance
    SFCErrorPtr exception = null   // Error
);

SFBDNSConfig::SetServers

This function is used to specify DNS server(s) to query.

[ public ]
SFCError SetServers(
    const INSockAddr* servers   // pointer to an array of count server addresses
    UInt16 count                // the number of servers in servers
);

Return value

If succeeds: SFERR_NO_ERROR
servers is not a valid pointer: SFERR_INVALID_MEMORY
If failed: SFERR_FAILED

Reference

BREW API IDNSCONFIG_SetServers