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




The operation completed successfully.



One or more parameters are incorrect or null.



Configuration data or schema on the server are malformed or corrupted.



The server resource (for example, a file or database) corresponding to the path bstrPath could not be found.



Access to the server resource (for example, a file or database) corresponding to the path bstrPath was denied.



The section specified by bstrSectionName is not supported.



Not enough memory is available to process this command.