ObjectReferenceTracker.SetListInfo(Int32, String, String) Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
This method allows you to provide metadata for an existing reference list.
public:
void SetListInfo(int refListID, System::String ^ usageLocation, System::String ^ usageDescription);
public void SetListInfo (int refListID, string usageLocation, string usageDescription);
member this.SetListInfo : int * string * string -> unit
Public Sub SetListInfo (refListID As Integer, usageLocation As String, usageDescription As String)
Parameters
- refListID
- Int32
The list ID in which the object is currently located.
- usageLocation
- String
The location where the object is used.
- usageDescription
- String
A description that explains where the object is being used.
Remarks
After a new reference list is created, this method should be used to set the initial metadata. It is unlikely that the usageLocation
property will change, but it possible to update both usageLocation
and usageDescription
properties as often as necessary.
The usageLocation
is usually the name of the task or component that owns the list. This usageDescription
is intended to give more detailed descriptions of how the objects in the list are used.
The refListID
parameter is created when the list is newly generated using the AddReference method. The AddReference method returns to you a refListID
, and it contains the ID of the newly created list. This returned refListID
can be used in subsequent calls to add more references to the same list, remove references to the list, destroy a list, or when using the SetListInfo method.