3.1.4.1.1 GetAdminSection (Opnum 3)

The GetAdminSection method is received by the server in an RPC_REQUEST packet. In response, the server returns an IAppHostElement that contains a merging of one or more individual IAppHostElement objects, which are set at one or more places in the path hierarchy that is specified in the method call.

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

bstrSectionName: The name of the administration section to fetch. The server contains named IAppHostElement objects that are specified at one or more paths. The name of the IAppHostElement is called the "section name" of the element. This parameter represents the required section name. The section name syntax is specific to the implementation of the server.

bstrPath: The path hierarchy for which to find and merge IAppHostElement objects. The server uses this path as an indication of where to look for IAppHostElement objects. The server finds all the IAppHostElement objects that exist anywhere in this path. How the server parses this path and potentially maps it to the location of IAppHostElement objects is specific to each implementation.

ppAdminSection: Returns a merged IAppHostElement object that contains the merged contents of one or more IAppHostElement objects that are located at points in the hierarchy that is specified in bstrPath.

Return Values: The server MUST return zero if it successfully processes the message that is received from the client. 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 bstrSectionName is not supported.
0X00000008 ERROR_NOT_ENOUGH_MEMORY	Not enough memory is available to process this command.