MprAdminServerSetCredentials-Funktion (mprapi.h)

Die Funktionen MprAdminServerSetCredentials legen den vorab freigegebenen Schlüssel für den angegebenen Server fest.

Syntax

DWORD MprAdminServerSetCredentials(
  [in] MPR_SERVER_HANDLE hMprServer,
  [in] DWORD             dwLevel,
  [in] LPBYTE            lpbBuffer
);

Parameter

[in] hMprServer

Handle mit einem Windows-Server. Rufen Sie dieses Handle ab, indem Sie MprAdminMIBServerConnect aufrufen.

[in] dwLevel

Ein DWORD-Wert, der das Format beschreibt, in dem die Informationen im lpbBuffer-Parameter strukturiert sind. Muss Null sein.

[in] lpbBuffer

Ein Zeiger auf eine MPR_CREDENTIALSEX_1-Struktur , die den vorab freigegebenen Schlüssel für den Server enthält.

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_PARAMETER	Der lpbBuffer-Parameter ist NULL.
ERROR_NOT_SUPPORTED	Der dwLevel-Parameter ist nicht 0.
Andere	Verwenden Sie FormatMessage , um die Systemfehlermeldung abzurufen, die dem zurückgegebenen Fehlercode entspricht.

Hinweise

Der Server verwaltet einen einzelnen vorab freigegebenen Schlüssel für alle Benutzer.

Um den vorab freigegebenen Schlüssel zu löschen, rufen Sie MprAdminServerSetCredentials auf, wobei der MPR_CREDENTIALSEX_1dwSize-Member auf Null festgelegt ist.

Anforderungen

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

Weitere Informationen

MPR_CREDENTIALSEX_1

MprAdminServerGetCredentials

Routerverwaltungsfunktionen

Referenz zur Routerverwaltung