188.8.131.52.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.
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 bstrPath is not supported.
Not enough memory is available to process this command.