MprAdminServerGetCredentials-Funktion (mprapi.h)

  • Artikel

Die Funktion MprAdminServerGetCredentials ruft den vorab freigegebenen Schlüssel für den angegebenen Server ab.

Syntax

DWORD MprAdminServerGetCredentials(
  [in]  MPR_SERVER_HANDLE hMprServer,
  [in]  DWORD             dwLevel,
  [out] LPBYTE            *lplpbBuffer
);

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 lplpbBuffer-Parameter zurückgegeben werden. Muss Null sein.

[out] lplpbBuffer

Nach erfolgreicher Fertigstellung zeigt ein Zeiger auf eine MPR_CREDENTIALSEX_1 Struktur, die den vorab freigegebenen Schlüssel für den Server enthält. Geben Sie den von dieser Struktur belegten Arbeitsspeicher mit MprAdminBufferFree frei.

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 lplpbBuffer-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.

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

MprAdminServerSetCredentials

Routerverwaltungsfunktionen

Referenz zur Routerverwaltung