Sub StringGetNextAssoc( _
   ByVal poPos As IEdmPos5, _
   ByRef pbsRetKey As System.String, _
   ByRef pbsRetValue As System.String _
) 

void StringGetNextAssoc( 
   IEdmPos5 poPos,
   out System.string pbsRetKey,
   out System.string pbsRetValue
)

void StringGetNextAssoc( 
&   IEdmPos5^ poPos,
&   [Out] System.String^ pbsRetKey,
&   [Out] System.String^ pbsRetValue
) 

Parameters

poPos

IEdmPos5; position of the next key-value pair (see Remarks)

pbsRetKey

Key in the next pair

pbsRetValue

Value in the next pair

Before calling this method the first time, you must populate poPos with the interface to the position of the first key-value pair. Call one of the following to obtain IEdmPos5 for the position of the first pair:

• IEdmDictionary5::StringGetFirstPosition
• IEdmDictionary5::StringFindKeys
• IEdmDictionary5::StringFindValues

After calling this method the first time, poPos is automatically incremented every time it is called. Call this method repeatedly to obtain the rest of the key-value pairs.

Between calls, you should call IEdmPos5::IsNull to verify that you have not gone past the last key-value pair.

C++ programmers must release the returned strings by calling SysFreeString.

Return codes:

• S_OK: The method successfully executed.
• E_EDM_END_OF_LIST: You have gone past the end of the list.