3.1.4.20.4 GetMetadata (Opnum 6)

  • Article

The GetMetadata method is received by the server in an RPC_REQUEST packet. In response, the server returns the named metadata for the specified method schema. The metadata properties supported by this method are not mandated by this specification. The server MAY choose to support some metadata properties that are specific to its implementation. The server MAY also choose to not implement any properties.

 HRESULT GetMetadata(
   [in] BSTR bstrMetadataType,
   [out, retval] VARIANT* pValue
 );

bstrMetadataType: The name of the metadata.

pValue: Contains the value of the metadata.

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

0X80070032

ERROR_NOT_SUPPORTED

The metadata property requested by bstrMetadataType is not supported.