Documentation for C++ API

Is there documentation for the C++ API besides comments in TurboActivate.h?

What I'm looking for isn't meanings of parameters and return values (which are explained in the header file) but rather descriptions of what these functions do.

Which ones call the server?

What does it mean to "activate" a key? (I assume it means you stick in the registry, but I shouldn't have to assume).

Etc.

Is there documentation for the C++ API besides comments in TurboActivate.h?

What I'm looking for isn't meanings of parameters and return values (which are explained in the header file) but rather descriptions of what these functions do.

For example, which ones call the server?

For example, what does it mean to "activate" a key? (I assume it means you stick in the registry, but I shouldn't have to assume).

Etc.

We're working on making our online documentation better and adding per-function web documentation. Right now, the best way to understand the how to use TurboActivate is from the example projects. So, for C/C++ that's the "Example.c" file in the API\C folder.

Which ones call the server?

Any of the functions that can return TA_E_INET. Meaning any function that can return an internet connection error is a function that calls the LimeLM servers. That's currently:

  • Activate()
  • ActivateEx()
  • Deactivate()
  • IsGenuine()
  • IsGenuineEx()
  • ExtendTrial()
What does it mean to "activate" a key? (I assume it means you stick in the registry, but I shouldn't have to assume).

No, that's not what it means. A good place to learn about the broad concepts of activation are in the "What is hardware-locked licensing and why choose LimeLM?" article. If you don't have time to read the whole thing and just want to understand what activation is then you can skip to the How hardware-locked licensing works section.

Does that help?

Thanks a lot, Wyatt, for the speedy and thorough reply.

By the way, I think it's a great thing that you like to write at length here and in other forums. To me it's a big selling point for your software. I mention this because while googling LimeLM and its competitors, I ran across an old thread on Joel on Software where you were accused of posting sales spam. My reaction is the opposite. I *like* to hear the owner of a company talk substantively about his products and their market category. That's a good thing, not a bad one. Of course what you said there made me more likely to come here and pay you money. But that's a good thing because I'm looking for a place to spend money, and I *want* to find information that will help me make a good decision.

Which ones call the server?

Any of the functions that can return TA_E_INET.[/quote]Doh. I should have realized that. 🙂

Does that help?

I think so. Let me see if I understand. IsActivated() looks at the local stored copy of the cryptographically signed activation block. IsGenuine() gets a fresh copy from the server. Is that right?

I think so. Let me see if I understand. IsActivated() looks at the local stored copy of the cryptographically signed activation block. IsGenuine() gets a fresh copy from the server. Is that right?

Yep.

Thanks a lot, Wyatt, for the speedy and thorough reply.

I'm glad to help.