MprAdminInterfaceSetCredentials-Funktion (mprapi.h)

  • Artikel

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
ERROR_INVALID_PARAMETER
 Mindestens eine der folgenden Optionen muss zutreffen:
  • Der lpwsInterfaceName-Parameter ist NULL oder länger als MAX_INTERFACE_NAME_LEN.
  • Mindestens einer der Parameter lpwsUserName, lpwsPassword und lpwsDomainName ist zu lang und daher ungültig. Weitere Informationen finden Sie im Abschnitt Hinweise.
ERROR_NOT_ENOUGH_MEMORY
 Unzureichender Arbeitsspeicher, um eine neue Datenstruktur zu erstellen, die die Anmeldeinformationen enthält.
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, 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

Weitere Informationen

FormatMessage

MprAdminInterfaceGetCredentials

MprAdminInterfaceGetInfo

Routerverwaltungsfunktionen

Referenz zur Routerverwaltung