# null

# MediaGetProperty

[Valid for](../../../Shared/FeatureAvailability.md): CANoe DE • CANoe4SW DE

## Function Syntax

* `long MediaGetProperty(dword objHandle, char propertyName[], dword& value); // form 1`
* `long MediaGetProperty(dword objHandle, char propertyName[], dword length, char value[]); // form 2`
* `long MediaGetProperty(dword objHandle, char propertyName[], qword& value); // form 3`
* `long MediaGetProperty(dword objHandle, char propertyName[], dword length, byte value[]); // form 4`

## Description

The behavior of an object can be configured using properties. Properties can be retrieved on an object-specific basis for a media type object (e.g., returned by [MediaGetMediaType](CAPLfunctionMediaGetMediaType.md)).

## Parameters

* **propertyName**: Name of the property to be retrieved. For a list of properties that can be retrieved by this function see [Media Properties](../CAPLfunctionsMediaProperties.md) and [Major Media Types / Subtypes](../CAPLfunctionsMediaMajorMediaTypesSubtypes.md).
* **objHandle**: Media type handle.
* **length**: Number of characters in **value**. Set to [elCount](../../Other/Functions/CAPLfunctionElCount.md)(value).
* **value**: Returned value of the property.

## Return Values

* **0**: The function succeeded.
* **≠0**: [Error code](../CAPLfunctionsMediaErrorCodes.md)

## Example

—

[See Also](javascript:void\(0\);)
