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 |
|