TLSLicenseEnumBegin-Funktion

Beginnt die Enumeration von Lizenzen, die vom lizenzbasierten Remotedesktop basierend auf Suchkriterien ausgestellt werden.

Hinweis

Dieser Funktion ist keine Headerdatei oder Importbibliothek zugeordnet. Zum Aufrufen dieser Funktion müssen Sie eine benutzerdefinierte Headerdatei erstellen und die Funktionen LoadLibrary und GetProcAddress verwenden, um eine dynamische Verknüpfung mit Mstlsapi.dll.

Syntax

DWORD WINAPI TLSLicenseEnumBegin(
  _In_  TLS_HANDLE hHandle,
  _In_  DWORD      dwSearchParm,
  _In_  BOOL       bMatchAll,
  _In_  LSLicense  *lpSearchParm,
  _Out_ PDWORD     pdwErrCode
);

Parameter

hHandle [ In]

Handle für einen Remotedesktop Lizenzserver. Geben Sie ein Handle an, das von der TLSConnectToLsServer-Funktion geöffnet wird.

dwSearchParm [ In]

Gibt die Suchkriterien an. Der -Parameter kann eine oder eine Kombination der In der folgenden Liste beschriebenen Werte sein. Der -Parameter gibt den Typ des Schlüsselpakets und das zu durchsuchende Schlüsselpaket an.

LSLICENSE _ SEARCH _ LICENSEID (0x00000001)

Suchen Sie nach der Lizenz-ID.

LSLICENSE _ SEARCH _ KEYPACKID (0x00000002)

Suchen Sie nach der Schlüsselpaket-ID.

LSLICENSE _ SEARCH _ MACHINENAME (0x00000008)

Suchen Sie nach dem Computernamen.

LSLICENSE _ BENUTZERNAME _ SUCHEN (0x00000010)

Suchen Sie nach Benutzername.

LSLICENSE _ SEARCH _ ISSUEDATE (0X00000080)

Suchen Sie nach Dem Problemdatum.

LSLICENSE _ SEARCH _ EXPIREDATE (0x00000100)

Suche nach Ablaufdatum.

LSLICENSE _ _ NUMLICENSES DURCHSUCHEN (0x00000200)

Suchen Sie nach der Anzahl der Lizenzen.

LSLICENSE _ _ _ SUCHEINTRAGSSTATUS (0X20000000)

Suchen Sie nach dem Eintragsstatus.

LSLICENSE _ EXSEARCH _ LICENSESTATUS (0x00100000)

Suchen Sie nach lizenzstatus.

LSKEYPACK _ SEARCH _ ALL (0xFFFFFFFF)

Durchsuchen Sie alle Lizenzen.

bMatchAll [ In]

Gibt an, ob alle Suchwerte übereinstimmen.

lpSearchParm [ In]

Zeiger auf eine LSLicense-Struktur, die die Suchparameter angibt, nach denen gesucht werden soll.

pdwErrCode [ out]

Zeiger auf eine Variable, die bei der Rückgabe einen der folgenden Fehlercodes empfängt.

LSERVER _ S _ SUCCESS (0)

Der Aufruf ist erfolgreich.

LSERVER _ INTERNER _ _ E-FEHLER (5001)

Interner Fehler auf dem Lizenzserver.

LSERVER _ E _ _ UNGÜLTIGE SEQUENZ (5006)

Die aufrufende Sequenz war ungültig. Höchstwahrscheinlich wurde eine vorherige Enumeration nicht beendet.

LSERVER _ E _ SERVER _ AUSGELASTET (5007)

Der Lizenzserver ist zu ausgelastet, um die Anforderung zu verarbeiten.

LSERVER _ E _ OUTOFMEMORY (5008)

Die Anforderung kann aufgrund von unzureichendem Arbeitsspeicher nicht verarbeitet werden.

LSERVER _ E _ _ UNGÜLTIGE DATEN (5009)

Daten im Suchparameter sind ungültig.

Rückgabewert

Diese Funktion gibt die folgenden möglichen Rückgabewerte zurück.

RPC _ S _ OK

Der Aufruf war erfolgreich. Überprüfen Sie den Wert des pdwErrCode-Parameters, um den Rückgabecode für den Aufruf zu erhalten.

RPC _ S _ INVALID _ ARG

Das Argument war ungültig.

Requirements (Anforderungen)

Anforderung Wert
Unterstützte Mindestversion (Client)
Windows Vista
Unterstützte Mindestversion (Server)
Windows Server 2008
DLL
Mstlsapi.dll

Weitere Informationen

LSLicense

TLSConnectToLsServer

TLSLicenseEnumNext

TLSLicenseEnumEnd