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.