Freigeben über


TLSKeyPackEnumBegin-Funktion

Beginnt mit der Enumeration durch alle Schlüsselpakete, die auf einem Remotedesktop-Lizenzserver basierend auf Suchkriterien installiert sind.

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 TLSKeyPackEnumBegin(
  _In_  TLS_HANDLE hHandle,
  _In_  DWORD      dwSearchParm,
  _In_  BOOL       bMatchAll,
  _In_  LSKeyPack  *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. Dieser Parameter ist für die zukünftige Verwendung reserviert und muss 0xFFFFFFFF enthalten.

bMatchAll [in]

Gibt an, ob alle Suchwerte übereinstimmen sollen.

lpSearchParm [in]

Zeiger auf eine LSKeyPack-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
Mstlsapi.dll

Siehe auch

LSKeyPack

TLSConnectToLsServer

TLSKeyPackEnumWeiter

TLSKeyPackEnumEnd