MprAdminInterfaceSetCredentials-Funktion (mprapi.h)
Verwenden Sie die MprAdminInterfaceSetCredentials-Funktion , um die Domäne, den Benutzernamen und das Kennwort festzulegen, die für die Einwahl auf der angegebenen Schnittstelle für Die Bedarfswahl verwendet werden.
Syntax
DWORD MprAdminInterfaceSetCredentials(
[in] LPWSTR lpwsServer,
[in] LPWSTR lpwsInterfaceName,
[in] LPWSTR lpwsUserName,
[in] LPWSTR lpwsDomainName,
[in] LPWSTR lpwsPassword
);
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.
[in] lpwsUserName
Zeiger auf eine Unicode-Zeichenfolge mit NULL-Beendigung, die den Benutzernamen angibt.
Dieser Parameter ist optional. Wenn die aufrufende Anwendung NULL für diesen Parameter angibt, ändert die Funktion den dieser Schnittstelle zugeordneten Benutzernamen nicht.
[in] lpwsDomainName
Zeiger auf eine Unicode-Zeichenfolge mit NULL-Beendigung, die den Domänennamen angibt.
Dieser Parameter ist optional. Wenn die aufrufende Anwendung NULL für diesen Parameter angibt, ändert die Funktion den dieser Schnittstelle zugeordneten Domänennamen nicht.
[in] lpwsPassword
Zeiger auf eine Unicode-Zeichenfolge mit NULL-Beendigung, die das Kennwort angibt.
Dieser Parameter ist optional. Wenn die aufrufende Anwendung NULL für diesen Parameter angibt, ändert die Funktion das dieser Schnittstelle zugeordnete Kennwort nicht.
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 |
|---|---|
|
Mindestens eine der folgenden Optionen muss zutreffen:
|
|
Unzureichender Arbeitsspeicher, um eine neue Datenstruktur zu erstellen, die die Anmeldeinformationen enthält. |
|
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, entfernt MprAdminInterfaceSetCredentials alle Anmeldeinformationen für diese Schnittstelle.
Die Konstanten UNLEN, PWLEN und DNLEN sind die maximalen Längen für den Benutzernamen, das Kennwort und den Domänennamen. Diese Konstanten sind in Lmcons.h definiert.
Beachten Sie, dass sich die Reihenfolge der Parameter in MprAdminInterfaceSetCredentials von MprAdminInterfaceGetCredentials 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 |