adIncrementUsageCount
Increment ad usage (without tracking time in use).
- AdResult adIncrementUsageCount(
- AdInterfacePtr theInterface,
- const char * thePositionName,
- AdUsageCategory theCat );
| Routine | Required Header | Distribution |
|---|---|---|
| adIncrementUsageCount | <ad.h> | SDKZIP |
Return Value
This function returns AdResult_NO_ERROR upon success. Otherwise a valid AdResult error condition is returned. (see remarks)
Parameters
- theInterface
- [in] SDK interface previously initialized using adInitialize
- thePositionName
- [in] String name of the position registered with adRegisterPosition
- theCat
- [in] UC_VIEWS or UC_INTERACTIONS
Remarks
This function increments the usage count for the specified ad. Use this function when tracking non time-based interactions such as drinking a soda. See adBeginTrackUsageTime for a complete description of usage tracking.
Section Reference: Gamespy Advertising SDK
See Also: adBeginTrackUsageTime, adEndTrackUsageTime