TLSLicenseEnumBegin-Funktion
Beginnt die Enumeration von Lizenzen, die vom Remotedesktop-Lizenzserver basierend auf Suchkriterien ausgestellt werden.
Hinweis
Diese Funktion verfügt über keine zugeordnete Headerdatei oder Importbibliothek. Um diese Funktion aufzurufen, müssen Sie eine benutzerdefinierte Headerdatei erstellen und die Funktionen LoadLibrary und GetProcAddress zum dynamischen Verknüpfen mit Mstlsapi.dll verwenden.
Syntax
DWORD WINAPI TLSLicenseEnumBegin(
_In_ TLS_HANDLE hHandle,
_In_ DWORD dwSearchParm,
_In_ BOOL bMatchAll,
_In_ LSLicense *lpSearchParm,
_Out_ PDWORD pdwErrCode
);
Parameter
-
hHandle [in]
-
Verarbeiten sie mit einem Remotedesktop-Lizenzserver. Geben Sie ein Handle an, das von der TLSConnectToLsServer-Funktion geöffnet wird.
-
dwSearchParm [in]
-
Gibt die Suchkriterien an. Der Parameter kann ein oder eine Kombination der Werte sein, die in der folgenden Liste beschrieben werden. Der Parameter gibt den Typ des Schlüsselpakets und das zu durchsuchende Schlüsselpaket an.
-
LSLICENSE_SEARCH_LICENSEID (0x00000001)
-
Suchen Sie nach Lizenz-ID.
-
LSLICENSE_SEARCH_KEYPACKID (0x00000002)
-
Suchen Sie nach Key Pack-ID.
-
LSLICENSE_SEARCH_MACHINENAME (0x00000008)
-
Suchen Sie nach Computername.
-
LSLICENSE_SEARCH_USERNAME (0x00000010)
-
Suchen Sie nach Benutzername.
-
LSLICENSE_SEARCH_ISSUEDATE (0x00000080)
-
Suche nach Ausgabedatum.
-
LSLICENSE_SEARCH_EXPIREDATE (0x00000100)
-
Suchen Sie nach Ablaufdatum.
-
LSLICENSE_SEARCH_ NUMLICENSES (0x00000200)
-
Suchen Sie nach Anzahl von Lizenzen.
-
LSLICENSE_SEARCH_ ENTRY_STATUS (0x20000000)
-
Suchen Sie nach eintrag status.
-
LSLICENSE_EXSEARCH_LICENSESTATUS (0x00100000)
-
Suchen Sie nach lizenz status.
-
LSKEYPACK_SEARCH_ALL (0xFFFFFFFF)
-
Durchsuchen Sie alle Lizenzen.
bMatchAll [in]
Gibt an, ob alle Suchwerte übereinstimmen sollen.
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_E_INTERNAL_ERROR (5001)
Interner Fehler im Lizenzserver.
LSERVER_E_INVALID_SEQUENCE (5006)
Die Aufrufsequenz war ungültig. Höchstwahrscheinlich wurde eine vorherige Enumeration nicht beendet.
LSERVER_E_SERVER_BUSY (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_INVALID_DATA (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 abzurufen.
-
RPC_S_INVALID_ARG
-
Das Argument war ungültig.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows Vista |
| Unterstützte Mindestversion (Server) |
WindowsServer 2008 |
| DLL |
|