Share via

IWMSContext.SetStringValue (C#)

  • Article

banner art

Previous Next

IWMSContext.SetStringValue (C#)

The SetStringValue method specifies a string value in the context.

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.

pstrValue

string containing the value.

lOptions

int containing either zero or the following WMS_CONTEXT_OPTIONS enumeration flag. If this parameter is zero, the string is specified by value.

Value Description
WMS_CONTEXT_SET_PROPERTY_STRING_BY_REFERENCE The string must be specified by reference.

Return Values

This method does not return a value.

If this method fails, it throws an exception.

Number Description
0x80070057 The pstrName parameter is null.
0x8007000E Could not allocate memory for the value.

Example Code

Guid ContextGuid = typeof(IWMSContext).GUID;
IWMSContext     Context;
IntPtr          pUnknown;

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);
}
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