Share via

IMLUserStore::PutValue (Compact 7)

  • Article

3/12/2014

This method sets the value associated with an application-defined key in the Media Library's persistent store.

Syntax

HRESULT PutValue (
  BSTR applicationName,
  BSTR key,
  BSTR pValue
);

Parameters

  • applicationName
    [in] Name of the application.
  • key
    [in] Name of the key.
  • pValue
    [in] Pointer to the value for the key.

Return Values

Returns the HRESULT values shown in the following table.

Value Description

S_OK

The method was successful.

E_INVALIDARG

One or more parameters are invalid.

E_POINTER

The pValue parameter is invalid.

E_FAIL

The method was not successful.

E_MEMORY

An out of memory error occurred.

Remarks

Applications can use the Media Library's persistent storage to store any type of application-specific information. This method creates a new key and value pair that is stored under the application name in the store. The Media Library does not parse or alter this information other than to retrieve it in the call to IMLUserStore::GetValue.

Requirements

Header

mlibdll.h,
mlibdll.idl

Library

mlibdll.lib

See Also

Reference

IMLUserStore