TCDVcsNextPromotionLabel

Locates and returns the next higher Promotion Level based on the currently selected View.

Delphi (TCDirectIntf.pas)

function VcsNextPromotionLabel( var PromotionID: Cardinal; var PromotionLabel: String ): Integer;

Parameters

Name	Description
PromotionID (Out)	Returns the ID of the next higher Promotion Level
PromotionLabel (Out)	Returns the Name associated with the next higher Promotion Level

Return Value

Err_OK if successful or an error code indicating the error.

Remarks

The next higher Promotion Level is defined by the currently selected View. If the current View is based on a Version Label, the next higher level will be the first Promotion Level. If the current View is based on a Promotion Level, the next higher level (if any) will be returned.

If the <default> View is current, or the current View is based on neither a Version Label or Promotion Level, first Promotion Level will be returned.

Exported

function TCDVcsNextPromotionLabel( var PromotionID: Cardinal; const pPromotionLabel: PChar ): Integer; stdcall;