<div class="content" name="GetConfigFile" uuid="f97ca13f-3e34-402b-a0fb-053d676a064e"><p>The GetConfigFile method is received by the server in an
RPC_REQUEST packet. In response, the server returns an <a href="3687acff-fb79-4e02-8349-6ca2f49df2a5" data-linktype="relative-path">IAppHostConfigFile</a> for the
specific hierarchy path.</p><p>The administration system implementation can choose to fail
if the specified hierarchy path does not have an IAppHostConfigFile container
for it. Or it can choose to succeed and create an empty IAppHostConfigFile
container instead. </p><dl>
<dd>
<div><pre> HRESULT GetConfigFile(
   [in] BSTR bstrConfigPath,
   [out, retval] IAppHostConfigFile** ppConfigFile
 );
</pre></div>
</dd></dl><p><b>bstrConfigPath: </b>The hierarchy path for the
IAppHostConfigFile to retrieve.</p><p><b>ppConfigFile: </b>Contains an IAppHostConfigFile
object for the specified path.</p><p><b>Return Values: </b>The server MUST return zero if
it successfully processes the message that is received from the client. In this
case, *ppConfigFile is not NULL. If processing fails, the server MUST return a
nonzero <a href="../ms-dtyp/a9046ed2-bfb2-4d56-a719-2824afce59ac" data-linktype="relative-path">HRESULT</a>
code as defined in <a href="../ms-erref/1bc92ddf-b79e-413c-bbaa-99a5281a6c90" data-linktype="relative-path">[MS-ERREF]</a>.
The following table describes the error conditions that MUST be handled and the
corresponding error codes. A server MAY return additional
implementation-specific error codes.</p><dl>
<dd>
<table><thead>
  <tr>
   <th>
   <p>Return value/code</p>
   </th>
   <th>
   <p>Description</p>
   </th>
  </tr>
 </thead><tbody><tr>
  <td>0X00000000 NO_ERROR</td>
  <td>The operation completed successfully.</td>
 </tr><tr>
  <td>0X80070057 ERROR_INVALID_PARAMETER</td>
  <td>One or more parameters are incorrect or null.</td>
 </tr><tr>
  <td>0X80070013 ERROR_INVALID_DATA</td>
  <td>Configuration data or schema on the server are malformed or corrupted.</td>
 </tr><tr>
  <td>0X80070002 ERROR_FILE_NOT_FOUND</td>
  <td>The server resource (for example, a file or database) corresponding to bstrConfigPath could not be found.</td>
 </tr><tr>
  <td>0X80070005 ERROR_ACCESS_DENIED</td>
  <td>Access to a server resource (for example, a file on a disk) was denied.</td>
 </tr><tr>
  <td>0X00000008 ERROR_NOT_ENOUGH_MEMORY</td>
  <td>Not enough memory is available to process this command.</td>
 </tr></tbody></table>
</dd></dl><p> </p></div>