IWMSContext.RemoveValue (C#)

The RemoveValue method removes a specific value from the context.

void IWMSContext.RemoveValue(
  string pstrName,
  int lNameHint,
  int lOptions
);

Arguments

	string specifying the name portion of the name-value pair in the context.
	int containing an optional key that can be used to more efficiently access a value.
	Reserved for future use.

Return Value

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.

Example

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);
    Context.SetLongValue(WMSDefines.WMS_CONTENT_DESCRIPTION_NO_SKIP,
                         WMSDefines.WMS_CONTENT_DESCRIPTION_NO_SKIP_ID,
                         1, 0);

    Context.RemoveValue(WMSDefines.WMS_CONTENT_DESCRIPTION_TITLE,
                        WMSDefines.WMS_CONTENT_DESCRIPTION_TITLE_ID,
                        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

Concepts

IWMSContext Object (C#)