MprAdminInterfaceSetCredentialsEx-Funktion (mprapi.h)

Artikel
03/04/2024

Verwenden Sie die MprAdminInterfaceSetCredentialsEx-Funktion , um erweiterte Anmeldeinformationen für eine Schnittstelle festzulegen. Verwenden Sie diese Funktion, um Anmeldeinformationen festzulegen, die für Extensible Authentication Protocols (EAPs) verwendet werden.

Syntax

DWORD MprAdminInterfaceSetCredentialsEx(
  [in] MPR_SERVER_HANDLE hMprServer,
  [in] HANDLE            hInterface,
  [in] DWORD             dwLevel,
  [in] LPBYTE            lpbBuffer
);

Parameter

[in] hMprServer

Handle mit einem Router. Dieses Handle wird aus einem vorherigen Aufruf von MprAdminServerConnect abgerufen.

[in] hInterface

Handle mit der Schnittstelle. Dieses Handle wird aus einem vorherigen Aufruf von MprAdminInterfaceCreate abgerufen.

[in] dwLevel

Ein DWORD-Wert, der das Format beschreibt, in dem die Informationen im lpbBuffer-Parameter strukturiert sind. Zulässige Werte für dwLevel umfassen 0 oder 1, wie in der folgenden Tabelle aufgeführt. Der Wert 1 gibt an, dass es sich bei den Informationen um einen vorab freigegebenen Schlüssel für die Schnittstelle handelt.

Wert	Strukturformat
0	Windows 2000 Server: MPR_CREDENTIALSEX_0
1	Windows Server 2003 oder höher: MPR_CREDENTIALSEX_1

[in] lpbBuffer

Ein Zeiger auf eine MPR_CREDENTIALSEX_0- oder MPR_CREDENTIALSEX_1-Struktur . Der dwLevel-Parameter gibt den Typ der Struktur an.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert NO_ERROR.

Wenn die Funktion fehlschlägt, ist der Rückgabewert einer der folgenden Fehlercodes.

Wert	Bedeutung
ERROR_ACCESS_DENIED	Die aufrufende Anwendung verfügt nicht über ausreichende Berechtigungen.
ERROR_INVALID_HANDLE	Der hInterface-Wert ist ungültig.
ERROR_INVALID_PARAMETER	Der lplpbBuffer-Parameter ist NULL.
ERROR_NOT_ENOUGH_MEMORY	Unzureichende Ressourcen, um den Vorgang abzuschließen.
ERROR_NOT_SUPPORTED	Der dwLevel-Wert ist ungültig.

Hinweise

Um einen vorab freigegebenen Schlüssel zu löschen, rufen Sie MprAdminInterfaceSetCredentials auf, wobei das dwSize-Element der MPR_CREDENTIALSEX_1 Struktur auf 0 festgelegt ist.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	mprapi.h
Bibliothek	Mprapi.lib
DLL	Mprapi.dll