Freigeben über


MprAdminInterfaceGetCredentialsEx-Funktion (mprapi.h)

Verwenden Sie die Funktion MprAdminInterfaceGetCredentialsEx , um erweiterte Anmeldeinformationen für die angegebene Schnittstelle abzurufen. Verwenden Sie diese Funktion, um Anmeldeinformationen abzurufen, die für Extensible Authentication Protocols (EAPs) verwendet werden.

Syntax

DWORD MprAdminInterfaceGetCredentialsEx(
  [in]  MPR_SERVER_HANDLE hMprServer,
  [in]  HANDLE            hInterface,
  [in]  DWORD             dwLevel,
  [out] LPBYTE            *lplpbBuffer
);

Parameter

[in] hMprServer

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

[in] hInterface

Handle für die -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 lplpbBuffer-Parameter zurückgegeben werden. Zulässige Werte für dwLevel sind 0 oder 1, wie in der folgenden Tabelle aufgeführt.

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

Der Wert 1 gibt an, dass es sich bei den Informationen um einen vorab freigegebenen Schlüssel für die Schnittstelle handelt, der in einem verschlüsselten Format vorliegt.

[out] lplpbBuffer

Bei erfolgreicher Fertigstellung ein Zeiger auf eine MPR_CREDENTIALSEX_0- oder MPR_CREDENTIALSEX_1-Struktur . Der dwLevel-Parameter gibt den Typ der Struktur an. 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_HANDLE
Der hInterface-Wert ist ungültig.
ERROR_INVALID_PARAMETER
Der lplpbBuffer-Parameter ist NULL.
ERROR_NOT_ENOUGH_MEMORY
Unzureichende Ressourcen zum Abschließen des Vorgangs.
ERROR_NOT_SUPPORTED
Der dwLevel-Wert ist ungültig.

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

Weitere Informationen

MPR_CREDENTIALSEX_0

MPR_CREDENTIALSEX_1

MprAdminInterfaceErstellen

MprAdminInterfaceGetCredentials

MprAdminInterfaceSetCredentialsEx

MprAdminServerConnect