Previous in Contents Next in Contents

IDictionary::PutMultiple

The PutMultiple method adds specified elements to the IDictionary collection, and initializes these elements to the specified values.

Syntax

HRESULT PutMultiple(
longcb,// in
const LPOLESTRrgolestr[],// in
const VARIANTrgvar[]// in
);

Parameters

cb
Identifies the number of elements in the rgolestr and rgvar arrays.
rgolestr
Contains the names of the elements to add to the IDictionary collection.
rgvar
Contains the values to add to the IDictionary collection.

Include File

<commerce.h>

Return Value

If successful, this method returns S_OK. Otherwise, it returns an HRESULT that indicates failure.

Remarks

A one-to-one mapping exists between the elements of the rgolestr and rgvar arrays. This means that rgolestr[n] is added to the IDictionary collection and is initialized to rgvar[n].

If the element specified by rgolestr[n] is already in the Dictionary, the value associated with the element is overwritten with the value stored in rgvar[n].

Note  This method cannot be invoked from VBScript because the method requires data types that VBScript does not support.

Related Topic

IDictionary::GetMultiple


© 1997-2000 Microsoft Corporation. All rights reserved.