49 lines
1.1 KiB
Markdown
49 lines
1.1 KiB
Markdown
# PR_GetHostByName
|
|
|
|
Looks up a host by name.
|
|
|
|
## Syntax
|
|
|
|
```{code}
|
|
#include <prnetdb.h>
|
|
|
|
PRStatus PR_GetHostByName(
|
|
const char *hostname,
|
|
char *buf,
|
|
PRIntn bufsize,
|
|
PRHostEnt *hostentry);
|
|
```
|
|
|
|
### Parameters
|
|
|
|
The function has the following parameters:
|
|
|
|
`hostname`
|
|
|
|
: The character string defining the host name of interest.
|
|
|
|
`buf`
|
|
|
|
: A pointer to a buffer, allocated by the caller, that is filled in
|
|
with host data on output. All of the pointers in the `hostentry`
|
|
structure point to data saved in this buffer. This buffer is
|
|
referenced by the runtime during a call to {ref}`PR_EnumerateHostEnt`.
|
|
|
|
`bufsize`
|
|
|
|
: Number of bytes in the `buf` parameter. The buffer must be at least
|
|
{ref}`PR_NETDB_BUF_SIZE` bytes.
|
|
|
|
`hostentry`
|
|
|
|
: This structure is allocated by the caller. On output, this structure
|
|
is filled in by the runtime if the function returns `PR_SUCCESS`.
|
|
|
|
### Returns
|
|
|
|
The function returns one of the following values:
|
|
|
|
- If successful, `PR_SUCCESS`.
|
|
- If unsuccessful, `PR_FAILURE`. You can retrieve the reason for the
|
|
failure by calling {ref}`PR_GetError`.
|