Share via


IWMSContext.GetArrayValue (C#)

banner art

Previous Next

IWMSContext.GetArrayValue (C#)

The GetArrayValue method retrieves an array of string values.

Syntax

  

Parameters

pstrName

string specifying the name portion of the name-value pair in the context.

lNameHint

int containing an optional key that can be used to more efficiently access a value.

ppsaValue

Reference to an array of string values.

lOptions

Reserved for future use.

Return Values

This method does not return a value.

If this method fails, it throws an exception.

Number Description
0x8002000B The property specified by the pstrName parameter could not be found.
0x80020005 The data type of the property specified by the pstrName parameter is not VT_ARRAY.
0x80004003 ppsaValue is null.

Example Code

Guid ContextGuid = typeof(IWMSContext).GUID;
IWMSContext     Context;
IntPtr          pUnknown;
string[]        Colors;

try
{          
    m_ClassFactory.AllocIWMSContext(ref ContextGuid,
                                   WMS_CONTEXT_TYPE.WMS_USER_CONTEXT_TYPE,
                                   pUserContext, out pUnknown);
    Context = (IWMSContext)Marshal.GetTypedObjectForIUnknown(pUnknown,
                                                     typeof(IWMSContext));
            
    Context.SetStringValue(WMSDefines.WMS_CONTENT_DESCRIPTION_TITLE,
                           WMSDefines.WMS_CONTENT_DESCRIPTION_TITLE_ID,
                           "My Title", 0);
    Context.SetLongValue(WMSDefines.WMS_CONTENT_DESCRIPTION_NO_SKIP,
                         WMSDefines.WMS_CONTENT_DESCRIPTION_NO_SKIP_ID,
                         1, 0);

    Context.GetArrayValue("ColorValues",
                      WMS_CONTEXT_HINT_CONSTANTS.WMS_CONTEXT_NO_NAME_HINT,
                      out Colors, 0);
}
catch( Exception e )
{
    // TODO: Handle exceptions.
}

Requirements

Reference: Add a reference to Microsoft.WindowsMediaServices.

Namespace: Microsoft.WindowsMediaServices.Interop.

Assembly: Microsoft.WindowsMediaServices.dll.

Library: WMSServerTypeLib.dll.

Platform: Windows Server 2003, Enterprise Edition; Windows Server 2003, Datacenter Edition; Windows Server 2008.

See Also

Previous Next