MprAdminInterfaceGetCredentials-Funktion (mprapi.h)

Artikel
08/24/2023

Verwenden Sie die MprAdminInterfaceGetCredentials-Funktion , um die Domäne, den Benutzernamen und das Kennwort für die Einwahl über die angegebene Schnittstelle für die Bedarfswahl abzurufen.

Syntax

DWORD MprAdminInterfaceGetCredentials(
  [in]  LPWSTR lpwsServer,
  [in]  LPWSTR lpwsInterfaceName,
  [out] LPWSTR lpwsUserName,
  [out] LPWSTR lpwsPassword,
  [out] LPWSTR lpwsDomainName
);

Parameter

[in] lpwsServer

Zeiger auf eine Unicode-Zeichenfolge mit Null-Beendigung, die den Namen des Routers angibt, auf dem dieser Aufruf ausgeführt werden soll.

Dieser Parameter ist optional. Wenn die aufrufende Anwendung NULL für diesen Parameter angibt, wird der Aufruf auf dem lokalen Computer ausgeführt.

[in] lpwsInterfaceName

Zeiger auf eine Unicode-Zeichenfolge mit NULL-Beendigung, die den Namen der Schnittstelle mit Bedarf angibt. Verwenden Sie MprAdminInterfaceGetInfo , um den Schnittstellennamen abzurufen.

[out] lpwsUserName

Zeiger auf eine Unicode-Zeichenfolge, die den Namen des Benutzers empfängt. Diese Zeichenfolge sollte UNLEN+1 lang sein.

Dieser Parameter ist optional. Wenn die aufrufende Anwendung NULL für diesen Parameter angibt, gibt die Funktion den Benutzernamen nicht zurück.

[out] lpwsPassword

Zeiger auf eine Unicode-Zeichenfolge, die das Kennwort empfängt. Diese Zeichenfolge sollte PWLEN+1 lang sein.

Dieser Parameter ist optional. Wenn die aufrufende Anwendung NULL für diesen Parameter angibt, gibt die Funktion das Kennwort nicht zurück.

[out] lpwsDomainName

Zeiger auf eine Unicode-Zeichenfolge, die den Domänennamen empfängt. Diese Zeichenfolge sollte DNLEN+1 lang sein.

Dieser Parameter ist optional. Wenn die aufrufende Anwendung NULL für diesen Parameter angibt, gibt die Funktion den Domänennamen nicht zurück.

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_CANNOT_FIND_PHONEBOOK_ENTRY	Der angegebenen Schnittstelle sind keine Bedarfswählparameter zugeordnet.
ERROR_INVALID_PARAMETER	Der lpwsInterfaceName-Parameter ist NULL.
NO_ERROR	Die Parameter lpwsUserName, lpwsPassword und lpwsDomainName sind alle NULL.
Andere	Verwenden Sie FormatMessage , um die Systemfehlermeldung abzurufen, die dem zurückgegebenen Fehlercode entspricht.

Hinweise

Die Parameter lpwsUserName, lpwsPassword und lpwsDomainName sind optional. Wenn die aufrufende Anwendung NULL für alle drei Parameter angibt, gibt MprAdminInterfaceGetCredentials NO_ERROR zurück, und die Domäne, der Benutzername und das Kennwort werden nicht zurückgegeben.

Die Konstanten UNLEN, PWLEN und DNLEN sind die maximalen Längen für den Benutzernamen, das Kennwort und den Domänennamen. Diese Konstanten werden in lmcons.h definiert.

Beachten Sie, dass sich die Reihenfolge der Parameter in MprAdminInterfaceGetCredentials von MprAdminInterfaceSetCredentials unterscheidet.

Anforderungen


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

FormatMessage

MprAdminInterfaceSetCredentials

Routerverwaltungsfunktionen

Referenz zur Routerverwaltung

Share via