IFWXFirewall::GetHostByName
Method

Retrieves host information corresponding to a host name. This
method is similar to the WinSock gethostbyname method.

HRESULT GetHostByName(
const char*name, char*buf, int *buflen);

Parameters

name

[in] Pointer to the null-terminated name of the host.

buf

[out] Pointer to the data area to receive the hostent
data. The data area must be larger than the size of a
hostent structure because the supplied data area is used by
Windows Sockets to contain a hostent structure and all of
the data referenced by members of the hostent structure. A
buffer of MAXGETHOSTSTRUCT bytes is recommended.

buflen

[in, out] On input, specifies the size of data area for the
buf parameter. If the buffer is too small, the error code
ERROR_INSUFFICIENT_BUFFER is returned and the buflen
parameter receives the size of the required buffer.

Return Values

S_OK

Success, the buffer was filled with the host information.

HRESULT_FROM_WIN32(WSAENOBUFS)

Insufficient buffer space is available. (The buffer pointed to
by buf is not large enough to contain the host
information.)

HRESULT_FROM_WIN32(WSAHOST_NOT_FOUND)

Authoritative answer host not found.

HRESULT_FROM_WIN32(WSATRY_AGAIN)

A nonauthoritative host not found, or SERVERFAIL.

HRESULT_FROM_WIN32(WSANO_DATA)

Valid name, no data record of requested type.

Remarks

Unlike the IFWXSession::GetHostByName
method, this method does not check permissions or site and content
rules, does not log the name resolution, and cannot use autodial to
dial out for the name resolution.