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 |
|---|---|
|
Die aufrufende Anwendung verfügt nicht über ausreichende Berechtigungen. |
|
Der hInterface-Wert ist ungültig. |
|
Der lplpbBuffer-Parameter ist NULL. |
|
Unzureichende Ressourcen zum Abschließen des Vorgangs. |
|
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
MprAdminInterfaceGetCredentials