<div class="content"><p>The <b>RRouterInterfaceTransportGetGlobalInfo</b> method<a id="Appendix_A_Target_256"></a><a aria-label="Product behavior note 256" href="3bb906f0-b077-47ab-ad11-d8d807afde26#Appendix_A_256" data-linktype="relative-path">&lt;256&gt;</a> is used to get the entire
global information for the specified transport.</p><dl>
<dd>
<div><pre> DWORD RRouterInterfaceTransportGetGlobalInfo(
   [in] DIM_HANDLE hDimServer,
   [in] DWORD dwTransportId,
   [in, out] PDIM_INTERFACE_CONTAINER pInfoStruct
 );
</pre></div>
</dd></dl><p><b>hDimServer: </b>A handle to the RRASM server where
the call is executed, see section <a href="1f8cdbcc-9791-4a35-ad78-878b8d110e15" data-linktype="relative-path">3.1.3</a>.</p><p><b>dwTransportId: </b>Specifies the transport for
which the information is set (IPX, IPv4, or IPv6).  It MUST be one of the
following values.<a id="Appendix_A_Target_257"></a><a aria-label="Product behavior note 257" href="3bb906f0-b077-47ab-ad11-d8d807afde26#Appendix_A_257" data-linktype="relative-path">&lt;257&gt;</a></p><dl>
<dd>
<table><thead>
  <tr>
   <th>
   <p>Value</p>
   </th>
   <th>
   <p>Meaning</p>
   </th>
  </tr>
 </thead><tbody><tr>
  <td>
  <p>PID_IPX</p>
  <p>0x0000002B</p>
  </td>
  <td>
  <p>IPX protocol</p>
  </td>
 </tr><tr>
  <td>
  <p>PID_IP</p>
  <p>0x00000021</p>
  </td>
  <td>
  <p>IPv4 protocol</p>
  </td>
 </tr><tr>
  <td>
  <p>PID_IPV6</p>
  <p>0x00000057</p>
  </td>
  <td>
  <p>IPv6 protocol</p>
  </td>
 </tr></tbody></table>
</dd></dl><p><b>pInfoStruct: </b>Pointer to <a href="95609dbb-56aa-4b1b-a0e2-697864a141bd" data-linktype="relative-path"><b>DIM_INTERFACE_CONTAINER (section 2.2.1.2.1)</b></a>.
This pointer MUST NOT be NULL when calling this method and is allocated to the
size of the <b>DIM_INTERFACE_CONTAINER</b> structure. On successful completion,
the structure is populated with a <b>DIM_INTERFACE_CONTAINER</b> structure
having valid values for <b>dwGlobalInfoSize</b> and <b>pGlobalInfo</b> fields
which the caller SHOULD free when done using it.  </p><dl>
<dd>
<p>The <b>fGetGlobalInfo</b> of <b>DIM_INTERFACE_CONTAINER</b>
MUST be set to 1. The rest of the <b>DIM_INTERFACE_CONTAINER</b> fields SHOULD
not be set. </p>
</dd>
<dd>
<p>The <b>pGlobalInfo</b> and <b>dwGlobalInfoSize</b>
members of <b>DIM_INTERFACE_CONTAINER</b> will be populated on successful
completion of this method.</p>
</dd>
<dd>
<p>The pGlobalInfo member will point to a valid <a href="402d2cc2-dd94-487a-9bb1-fab6728c3e7d" data-linktype="relative-path"><b>RTR_INFO_BLOCK_HEADER (section 2.2.1.2.3)</b></a>
and <a href="c99955ec-6d18-4665-8d5b-e124de63a368" data-linktype="relative-path"><b>RTR_TOC_ENTRY (section 2.2.1.2.4)</b></a>.  
</p>
</dd>
<dd>
<p>On successful completion <b>dwGlobalInfoSize</b>
will be set to the size of the information being passed in <b>pGlobalInfo</b>.</p>
</dd>
<dd>
<p>If <i>dwTransportId</i> is PID_IP or PID_IP6 and if
the <b>InfoType</b> field in the RTR_TOC_ENTRY structure is one of the
following, <b>pGlobalInfo</b> MUST be interpreted as the structure in the
following table.</p>
</dd>
<dd>
<table><thead>
  <tr>
   <th>
   <p>InfoType value</p>
   </th>
   <th>
   <p>Meaning </p>
   </th>
   <th>
   <p>Structure pointed to by pGlobalInfo</p>
   </th>
  </tr>
 </thead><tbody><tr>
  <td>
  <p>MS_IP_BOOTP</p>
  <p>0x0000270F</p>
  </td>
  <td>
  <p>IP BOOTP global configuration information.</p>
  </td>
  <td>
  <p><a href="4419f3c5-188e-4824-8006-39ad9b105b9d" data-linktype="relative-path">IPBOOTP_GLOBAL_CONFIG (section 2.2.1.2.149)</a></p>
  </td>
 </tr><tr>
  <td>
  <p>MS_IP_IGMP</p>
  <p>0x4137000A</p>
  </td>
  <td>
  <p>IGMP global configuration.</p>
  </td>
  <td>
  <p><a href="0c8cd37c-b9c0-44d1-a73d-8822717c9927" data-linktype="relative-path">IGMP_MIB_GLOBAL_CONFIG (section 2.2.1.2.173)</a></p>
  </td>
 </tr><tr>
  <td>
  <p>MS_IP_RIP</p>
  <p>0x00000008</p>
  </td>
  <td>
  <p>IP RIP global configuration information.</p>
  </td>
  <td>
  <p><a href="bd082244-f666-4d4d-9ef3-cade80b09c13" data-linktype="relative-path">IPRIP_GLOBAL_CONFIG (section 2.2.1.2.164)</a>
  (values specified are overwritten)</p>
  </td>
 </tr><tr>
  <td>
  <p>MS_IP_BGP</p>
  <p>0x0137000E</p>
  </td>
  <td>
  <p>BGP configuration.</p>
  </td>
  <td>
  <p>When <i>dwTransportId</i> is PID_IP, the structure
  pointed to, at the offset is <a href="cf155bce-58dd-492d-8883-6a920c767d19" data-linktype="relative-path">BGP_CONFIG_HEADER (section 2.2.1.2.252)</a>.</p>
  <p>When <i>dwTransportId</i> is PID_IP6, the structure
  pointed to, at the offset is <a href="d3faa796-bc6b-4d1a-ad97-a75068a1acbb" data-linktype="relative-path">BGP_ROUTER_V6 (section 2.2.1.2.265)</a>.</p>
  </td>
 </tr><tr>
  <td>
  <p>MS_IP_DHCP_ALLOCATOR</p>
  <p>0x81372714</p>
  </td>
  <td>
  <p>DHCP global configuration information.</p>
  </td>
  <td>
  <p>IP_AUTO_DHCP_GLOBAL_INFO (section <a href="8c173961-b72b-4115-a23a-a90f8270cbc0" data-linktype="relative-path">2.2.1.2.191)</a> (values
  specified are overwritten)</p>
  </td>
 </tr><tr>
  <td>
  <p>MS_IP_DNS_PROXY</p>
  <p>0x81372713</p>
  </td>
  <td>
  <p>DNS proxy global configuration information.</p>
  </td>
  <td>
  <p>IP_DNS_PROXY_GLOBAL_INFO (section <a href="91d78735-4aef-4dd1-a0e4-b71beb6f7a2e" data-linktype="relative-path">2.2.1.2.193)</a> (values
  specified are overwritten)</p>
  </td>
 </tr><tr>
  <td>
  <p>MS_IP_OSPF<a id="Appendix_A_Target_258"></a><a aria-label="Product behavior note 258" href="3bb906f0-b077-47ab-ad11-d8d807afde26#Appendix_A_258" data-linktype="relative-path">&lt;258&gt;</a></p>
  <p>0x0000000D</p>
  </td>
  <td>
  <p>OSPF global configuration information specified is
  retrieved. The type field is the first field in each of the structures and
  this defines which of the structures MUST be used. The type field MUST be
  OSPF_PARAM_TYPE (section <a href="10efed5b-70a2-4b65-9cd5-f362e89b4f62" data-linktype="relative-path">2.2.1.1.14</a>)
  and the value MUST be corresponding to the structures specified.</p>
  </td>
  <td>
  <p>OSPF_ROUTE_FILTER_INFO (section <a href="027f5f7a-ae39-44f2-95ac-f557c881a069" data-linktype="relative-path">2.2.1.2.209)</a></p>
  <p>OSPF_PROTO_FILTER_INFO (section <a href="1c930f3c-6b7a-4731-b124-3252f408f0ea" data-linktype="relative-path">2.2.1.2.210)</a></p>
  <p>OSPF_GLOBAL_PARAM (section <a href="0fd4f4e7-3dc1-4d39-93a9-fbcd073e3011" data-linktype="relative-path">2.2.1.2.211)</a></p>
  <p>OSPF_ROUTE_FILTER (section <a href="a29247c3-8119-48d8-b556-3113e75fd364" data-linktype="relative-path">2.2.1.2.208)</a></p>
  </td>
 </tr><tr>
  <td>
  <p>MS_IP_ALG<a id="Appendix_A_Target_259"></a><a aria-label="Product behavior note 259" href="3bb906f0-b077-47ab-ad11-d8d807afde26#Appendix_A_259" data-linktype="relative-path">&lt;259&gt;</a></p>
  <p>0x8137271A</p>
  </td>
  <td>
  <p>Application layer gateway global configuration.</p>
  </td>
  <td>
  <p>IP_ALG_GLOBAL_INFO (section <a href="cdff3af8-7599-4826-8a05-349bc0f9d41d" data-linktype="relative-path">2.2.1.2.201)</a></p>
  </td>
 </tr><tr>
  <td>
  <p>MS_IPV6_DHCP</p>
  <p>0x000003E7</p>
  </td>
  <td>
  <p>DHCPv6 Relay global configuration information.</p>
  </td>
  <td>
  <p>DHCPV6R_GLOBAL_CONFIG (section <a href="ce9b2f8e-aaa6-4d39-b935-28815acca0ff" data-linktype="relative-path">2.2.1.2.157)</a></p>
  </td>
 </tr><tr>
  <td>
  <p>MS_IP_NAT</p>
  <p>0x81372715</p>
  </td>
  <td>
  <p>IP NAT global configuration information.</p>
  </td>
  <td>
  <p>IP_NAT_GLOBAL_INFO (section <a href="a2965a02-bfe6-45d1-9c7d-c35b5b9edbbe" data-linktype="relative-path">2.2.1.2.195)</a></p>
  </td>
 </tr></tbody></table>
</dd></dl><p><b>Return Values: </b>A 32-bit, unsigned integer
value that indicates return status. A return value of ERROR_SUCCESS
(0x00000000) indicates that the operation was completed successfully; otherwise
it contains an error code, as specified in <a href="../ms-erref/1bc92ddf-b79e-413c-bbaa-99a5281a6c90" data-linktype="relative-path">[MS-ERREF]</a>
or in section <a href="5c0c991a-0d3d-4fe5-9503-5128d0d49fe1" data-linktype="relative-path">2.2.4</a>.
All values that are not in the table that follows MUST be treated the same by
the RRASM client.</p><dl>
<dd>
<table><thead>
  <tr>
   <th>
   <p>Return value/code</p>
   </th>
   <th>
   <p>Description</p>
   </th>
  </tr>
 </thead><tbody><tr>
  <td>
  <p>ERROR_SUCCESS</p>
  <p>0x00000000</p>
  </td>
  <td>
  <p>The call was successful.</p>
  </td>
 </tr><tr>
  <td>
  <p>ERROR_ACCESS_DENIED</p>
  <p>0x00000005</p>
  </td>
  <td>
  <p>The calling application does not have sufficient privileges.</p>
  </td>
 </tr></tbody></table>
</dd></dl><p>The opnum field value for this method is 10.</p><p>When processing this call, the RRASM server MUST do the
following:</p><ul><li><p><span><span> 
</span></span>Validate, as specified in section <a href="9373431f-ed29-4639-9f8b-743267c9f9b6" data-linktype="relative-path">2.1.1.1</a>, whether this
method was called by a client that has access to the method. If the client does
not have access, then return error ERROR_ACCESS_DENIED (0x00000005).</p>
</li><li><p><span><span> 
</span></span>If <i>pInfoStruct</i> is NULL, return an error other than one of
the errors specified in the preceding table.</p>
</li><li><p><span><span> 
</span></span>If <i>dwTransportId</i> is not specified in <b>SupportedTransportsList</b>,
return an error other than one of the errors specified in the preceding table.</p>
</li><li><p><span><span> 
</span></span>Call the abstract interface <b>Invoke DIMSVC</b> method
specifying the operation and the parameters to enable RRAS server to perform
the required management task.</p>
</li><li><p><span><span> 
</span></span>If the RRAS server successfully processes the request, populate
the returned information in the <i>pInfoStruct</i> with the information
returned by the RRAS server and return ERROR_SUCCESS.</p>
</li><li><p><span><span> 
</span></span>Otherwise return the error value provided by the RRAS server.</p>
</li></ul><p>No exceptions are thrown beyond those thrown by the
underlying RPC protocol <a href="../ms-rpce/290c38b1-92fe-4229-91e6-4fc376610c15" data-linktype="relative-path">[MS-RPCE]</a>.</p></div>