3.1.4.8.3 AddLocation (Opnum 5)

The AddLocation method is received by the server in an RPC_REQUEST packet. In response, the server attempts to create a new subpath container in the IAppHostConfigFile that provides the specified IAppHostConfigLocationCollection.

 HRESULT AddLocation(
   [in] BSTR bstrLocationPath,
   [out, retval] IAppHostConfigLocation** ppNewLocation
 );

bstrLocationPath: The new subpath to add.

ppNewLocation: Contains a new subpath container IAppHostConfigLocation object.

Return Values: The server MUST return zero if it successfully processes the message that is received from the client. In this case, *ppNewLocation 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.

0X80070005

ERROR_ACCESS_DENIED

The instance is not editable.

0X80070057

ERROR_INVALID_PARAMETER

One or more parameters are incorrect or null.

0X800700B7

ERROR_ALREADY_EXISTS

The location path specified by bstrLocationPath cannot be added since it already exists.

0X00000008

ERROR_NOT_ENOUGH_MEMORY

Not enough memory is available to process this command.

0X800700A1

ERROR_BAD_PATHNAME

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