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.