MprAdminInterfaceGetCredentials-Funktion (mprapi.h)
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 |
|---|---|
|
Der angegebenen Schnittstelle sind keine Bedarfswählparameter zugeordnet. |
|
Der lpwsInterfaceName-Parameter ist NULL. |
|
Die Parameter lpwsUserName, lpwsPassword und lpwsDomainName sind alle NULL. |
|
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 |