SolidWorksMakroprogrammierung

Objekt · SldWorks

SwPEClassFactory-Objekt

Das Rückrufobjekt, mit dem ein Add-in eines SOLIDWORKS-Partners seinen Lizenzschlüssel an SOLIDWORKS übergibt.

Deklaration Dim x As SldWorks.SwPEClassFactory · in der englischen .NET-Hilfe: ISwPEClassFactory

Beschreibung

SwPEClassFactory ist das Rückrufobjekt für die Prüfung der Partnerberechtigung (SOLIDWORKS Partner Program). Seit SOLIDWORKS 2021 registrieren Partner ihre Add-ins bei SOLIDWORKS und bekommen dafür einen Lizenzschlüssel. Beim Laden des Add-ins läuft dieser Ablauf:

  1. SOLIDWORKS ruft im Add-in SwPEManager.IdentifyToSW auf (Bibliothek swpublished) und übergibt dabei ein SwPEClassFactory.
  2. Das Add-in schickt mit SwPEClassFactory.SetPartnerKey seinen Lizenzschlüssel zurück.
  3. SOLIDWORKS prüft den Schlüssel und gibt ein SwPEToken zurück.

Je nach Ergebnis steht das Add-in unter Extras, Add-Ins bei „Partner Gold Add-ins“, „Partner Solution Add-ins“ oder bei „Other Add-ins“. Der Befehl ist seit SOLIDWORKS 2021 verfügbar.

Zugriff

  • Parameter ClassFactory von SwPEManager.IdentifyToSW. Diese Funktion setzt das Add-in selbst um, SOLIDWORKS ruft sie auf.

Beispiel

' Ausschnitt aus SwPEManager.IdentifyToSW in der Klasse eines Partner-Add-ins.
' Vorbedingung: Das Add-in ist registriert und setzt SwPEManager (swpublished) um.
'               SOLIDWORKS hat ClassFactory übergeben. Der Schlüssel kommt vom
'               SOLIDWORKS-Partnerprogramm.
' Ergebnis:     SOLIDWORKS prüft den Schlüssel. Bei Fehlern steht der Code im Direktfenster.
Dim swFactory As SldWorks.SwPEClassFactory
Dim swToken As Object
Dim nStatus As Long

Set swFactory = ClassFactory
nStatus = swFactory.SetPartnerKey("...", swToken)   ' Lizenzschlüssel des Partners
If nStatus <> swPESuccess Then
    Debug.Print "Partnerberechtigung nicht bestätigt, Code " & nStatus
End If

Bemerkungen

Nur für Partner-Add-ins: Gewöhnliche Makros und Add-ins brauchen das Objekt nicht. Ein Add-in ohne Schlüssel lädt weiter, es steht dann nur bei „Other Add-ins“. Beim Partnerprogramm gibt es ein Beispiel-Add-in, das SwAddin und SwPEManager schon umsetzt. Ein eigenes Hilfebeispiel gibt es nicht.

Mit der 3DEXPERIENCE-Plattform: Ist SOLIDWORKS mit der Plattform verbunden, lädt es ein Add-in mit abgelaufenem oder unpassendem Schlüssel gar nicht. Es steht dann nicht angehakt bei „Other Add-ins“.

VBA: Ein VBA-Makro wird nicht als Add-in geladen. SOLIDWORKS ruft IdentifyToSW deshalb nicht in einem Makro auf. Das Beispiel zeigt nur die Befehle, wie sie in einem Add-in in VB6 oder VB.NET stehen.

Eigenschaften und Methoden

Methoden 1, davon 1 beschrieben

NameBeschreibung
SetPartnerKeyÜbergibt den Lizenzschlüssel eines Partner-Add-ins an SOLIDWORKS und liefert das Ergebnis der Prüfung.

Siehe auch

Englisches Original: ISwPEClassFactory in der SOLIDWORKS API-Hilfe ↗ (dort mit dem .NET-Namen)

Fragen zu diesem Befehl oder ein Befehl fehlt? Frag im Discord.