IWMSContext.GetArrayValue (Visual Basic .NET)

banner art

Previous Next

IWMSContext.GetArrayValue (Visual Basic .NET)

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

Int32 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

Dim Context As IWMSContext
Dim pUnknown As IntPtr
Dim Colors As String()

Try
    m_ClassFactory.AllocIWMSContext(GetType(IWMSContext).GUID, _
                                 WMS_CONTEXT_TYPE.WMS_USER_CONTEXT_TYPE, _
                                 pUserContext, pUnknown)
    Context = Marshal.GetTypedObjectForIUnknown(pUnknown, _
                                                GetType(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, _
                    Colors, 0)

Catch e As Exception
    ' TODO: Handle exceptions.
End Try

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