#include <ppb_host_resolver.h>
The PPB_HostResolver
interface supports host name resolution.
Permissions: In order to run Resolve()
, apps permission socket
with subrule resolve-host
is required. For more details about network communication permissions, please see: http://developer.chrome.com/apps/app_network.html
Creates a host resolver resource.
- Parameters
-
[in] | instance | A PP_Instance identifying one instance of a module. |
- Returns
- A
PP_Resource
corresponding to a host reslover or 0 on failure.
Gets the canonical name of the host.
- Parameters
-
[in] | host_resolver | A PP_Resource corresponding to a host resolver. |
- Returns
- A string
PP_Var
on success, which is an empty string if PP_HOSTRESOLVER_FLAG_CANONNAME
is not set in the hint flags when calling Resolve()
; an undefined PP_Var
if there is a pending Resolve()
call or the previous Resolve()
call failed.
Gets a network address.
- Parameters
-
[in] | host_resolver | A PP_Resource corresponding to a host resolver. |
[in] | index | An index indicating which address to return. |
- Returns
- A
PPB_NetAddress
resource on success; 0 if there is a pending Resolve()
call or the previous Resolve()
call failed, or the specified index is out of range.
uint32_t(* PPB_HostResolver_1_0::GetNetAddressCount)(PP_Resource host_resolver) |
Gets the number of network addresses.
- Parameters
-
[in] | host_resolver | A PP_Resource corresponding to a host resolver. |
- Returns
- The number of available network addresses on success; 0 if there is a pending
Resolve()
call or the previous Resolve()
call failed.
Determines if a given resource is a host resolver.
- Parameters
-
[in] | resource | A PP_Resource to check. |
- Returns
PP_TRUE
if the input is a PPB_HostResolver
resource; PP_FALSE
otherwise.
Requests resolution of a host name. If the call completes successfully, the results can be retrieved by GetCanonicalName()
, GetNetAddressCount()
and GetNetAddress()
.
- Parameters
-
[in] | host_resolver | A PP_Resource corresponding to a host resolver. |
[in] | host | The host name (or IP address literal) to resolve. |
[in] | port | The port number to be set in the resulting network addresses. |
[in] | hint | A PP_HostResolver_Hint structure providing hints for host resolution. |
[in] | callback | A PP_CompletionCallback to be called upon completion. |
- Returns
- An int32_t containing an error code from
pp_errors.h
. PP_ERROR_NOACCESS
will be returned if the caller doesn't have required permissions. PP_ERROR_NAME_NOT_RESOLVED
will be returned if the host name couldn't be resolved.
The documentation for this struct was generated from the following file: