IClassFactory2::RequestLicKey-Methode (ocidl.h)

Artikel
02/29/2024

Erstellt einen Lizenzschlüssel, den der Aufrufer speichern und später verwenden kann, um eine instance des lizenzierten Objekts zu erstellen.

Syntax

HRESULT RequestLicKey(
  [in]  DWORD dwReserved,
  [out] BSTR  *pBstrKey
);

Parameter

[in] dwReserved

Dieser Parameter ist reserviert und muss null sein.

[out] pBstrKey

Ein Zeiger auf die vom Aufrufer zugewiesene Variable, die bei erfolgreicher Rückgabe von dieser Methode den aufgerufenen zugewiesenen Lizenzschlüssel empfängt. Dieser Parameter ist bei jedem Fehler auf NULL festgelegt.

Rückgabewert

Diese Methode kann die Standardrückgabewerte E_INVALIDARG, E_OUTOFMEMORY und E_UNEXPECTED sowie die folgenden Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Der Lizenzschlüssel wurde erfolgreich erstellt.
E_NOTIMPL	Diese Klassenfactory unterstützt keine Laufzeitlizenzschlüssel.
E_POINTER	Die in pbstrKey übergebene Adresse ist ungültig. Es kann z. B. NULL sein.
CLASS_E_NOTLICENSED	Diese Klassenfactory unterstützt die Laufzeitlizenzierung, aber der aktuelle Computer selbst ist nicht lizenziert. Daher ist auf diesem Computer kein Laufzeitschlüssel verfügbar.

Hinweise

Der Aufrufer kann den Lizenzschlüssel für nachfolgende Aufrufe von IClassFactory2::CreateInstanceLic speichern, um Objekte auf einem ansonsten nicht lizenzierten Computer zu erstellen.

Hinweise für Anrufer

Der Aufrufer muss den BSTR mit der SysFreeString-Funktion freigeben, wenn der Schlüssel nicht mehr benötigt wird. Der Wert von fRuntimeKeyAvail wird über einen vorherigen Aufruf von IClassFactory2::GetLicInfo zurückgegeben.

Hinweise zu Implementierern

Diese Methode weist den BSTR-SchlüsselSysAllocString oder SysAllocStringLen zu, und der Aufrufer wird für diesen BSTR verantwortlich, nachdem diese Methode erfolgreich zurückgegeben wurde.

Diese Methode muss nicht implementiert werden, wenn eine Klassenfactory keine Laufzeitlizenzschlüssel unterstützt.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	ocidl.h

Weitere Informationen

IClassFactory2

Freigeben über