Share via

IMLUserStore::GetValue (Compact 7)

  • Article

3/12/2014

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

Syntax

HRESULT GetValue (
  BSTR applicationName,
  BSTR key,
  BSTR *pValue
);

Parameters

  • applicationName
    [in] Name of the application.
  • key
    [in] Name of the key.
  • pValue
    [out] 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 returns a key and value pair that is stored under the application name in the store. The Media Library does not parse or alter the information returned by this call.

You must release the memory allocated for the pValue parameter by calling SysFreeString.

Requirements

Header

mlibdll.h,
mlibdll.idl

Library

mlibdll.lib

See Also

Reference

IMLUserStore