3.1.4.9.2 GetUniqueConfigPath (Opnum 4)

The GetUniqueConfigPath method is received by the server in an RPC_REQUEST packet. In response, the server returns the deepest hierarchy path (up to the specified hierarchy path) that contains a unique set of IAppHostElement objects. For example:

Assume: At hierarchy path A, a set of IAppHostElement objects exist.

Assume: At hierarchy path B (deeper than A), the identical set of objects exists.

Given these assumptions, GetUniqueConfigPath( B ) returns path A. In other words, the method returns the shallowest path that contains the identical set of IAppHostElement objects as the specified path.

 HRESULT GetUniqueConfigPath(
   [in] BSTR bstrConfigPath,
   [out, retval] BSTR* pbstrUniquePath
 );

bstrConfigPath: The hierarchy path for which to find the shallowest equivalent path.

pbstrUniquePath: Contains the shallowest equivalent path.

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

0X00000002

ERROR_PATH_NOT_FOUND

A server resource (for example, a file on a disk) could not be found.

0X80070005

ERROR_ACCESS_DENIED

Access to a server resource (for example, a file on a disk) was denied.

0X00000008

ERROR_NOT_ENOUGH_MEMORY

Not enough memory is available to process this command.