3.1.4.12.9 GetPropertyByName (Opnum 11)

  • Article

The GetPropertyByName method is received by the server in an RPC_REQUEST packet. In response, the server returns the IAppHostProperty of the specified name.

 HRESULT GetPropertyByName(
   [in] BSTR bstrSubName,
   [out, retval] IAppHostProperty** ppProperty
 );

bstrSubName: The name of the IAppHostProperty to fetch.

ppProperty: Contains an IAppHostProperty of the specified name.

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

0X80070585

ERROR_INVALID_INDEX

The property specified by bstrSubName could not be found.

0X00000008

ERROR_NOT_ENOUGH_MEMORY

Not enough memory is available to process this command.