TLSKeyPackEnumNext-Funktion

Artikel
06/12/2023

Setzt einen vorherigen Aufruf der TLSKeyPackEnumBegin-Funktion fort und gibt das nächste Key Pack zurück, das auf einem Remotedesktop-Lizenzserver installiert ist, der den Suchkriterien entspricht.

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 TLSKeyPackEnumNext(
  _In_  TLS_HANDLE hHandle,
  _In_  LsKeyPack  *lpKeyPack,
  _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.
lpKeyPack [in]: Zeiger auf eine LSKeyPack-Struktur , die das nächste Schlüsselpaket empfängt, das den Suchkriterien entspricht.
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_I_NO_MORE_DATA (4001): Die Suchkriterien entsprechen nicht mehr Key Packs.
LSERVER_E_INTERNAL_ERROR (5001): Interner Fehler im Lizenzserver.
LSERVER_E_INVALID_SEQUENCE (5006): Die Aufrufsequenz war ungültig. Die TLSKeyPackEnumBegin() -Funktion muss zuvor aufgerufen werden.
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.

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	Mstlsapi.dll

Siehe auch

LSKeyPack
TLSConnectToLsServer
TLSKeyPackEnumBegin
TLSKeyPackEnumEnd

Share via