3.1.4.6.4 GetAdminSection (Opnum 6)

The GetAdminSection method is received by the server in an RPC_REQUEST packet. In response, the server returns a single IAppHostElement at the specified hierarchy path in the specific IAppHostConfigFile. The section is not a merge and is instead a single IAppHostElement.

If no IAppHostElement object exists at the specified path, the implementation MAY return either an error or an empty IAppHostElement object (the default).

This method is used to get a specific administration section.

 HRESULT GetAdminSection(
   [in] BSTR bstrSectionName,
   [in] BSTR bstrPath,
   [out, retval] IAppHostElement** ppAdminSection
 );

bstrSectionName: The name of the IAppHostElement object to retrieve.

bstrPath: The hierarchy path of the IAppHostElement object to retrieve. It MUST be a path that is supported in the specific IAppHostConfigFile for the method to succeed and return an IAppHostElement object.

ppAdminSection: Contains an IAppHostElement from the specific IAppHostConfigFile.

Return Values: The server MUST return zero if it successfully processes the message that is received from the client. In this case, *ppAdminSection is not NULL. If processing fails, the server MUST return a nonzero HRESULT code as defined in [MS-ERREF]. 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.

Return value/code	Description
0X00000000  NO_ERROR	The operation completed successfully.
0X80070057  ERROR_INVALID_PARAMETER	One or more parameters are incorrect or null.
0X80070013 ERROR_INVALID_DATA	Configuration data or schema on the server are malformed or corrupted.
0X80070002  ERROR_FILE_NOT_FOUND	The server resource (for example, a file or database) corresponding to the path bstrPath could not be found.
0X80070005 ERROR_ACCESS_DENIED	Access to the server resource (for example, a file or database) corresponding to the path bstrPath was denied.
0X00000002  ERROR_PATH_NOT_FOUND	The section specified by bstrPath is not supported.
0X00000008  ERROR_NOT_ENOUGH_MEMORY	Not enough memory is available to process this command.