Funzione MprAdminInterfaceSetCredentials (mprapi.h)

Articolo
03/15/2023

Utilizzare la funzione MprAdminInterfaceSetCredentials per impostare il dominio, il nome utente e la password che verranno usati per la composizione dell'interfaccia di chiamata a richiesta specificata.

Sintassi

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

Parametri

[in] lpwsServer

Puntatore a una stringa Unicode con terminazione Null che specifica il nome del router in cui eseguire questa chiamata.

Questo parametro è facoltativo e, Se l'applicazione chiamante specifica NULL per questo parametro, la chiamata viene eseguita nel computer locale.

[in] lpwsInterfaceName

Puntatore a una stringa Unicode con terminazione Null che specifica il nome dell'interfaccia di composizione della richiesta. Usare MprAdminInterfaceGetInfo per ottenere il nome dell'interfaccia.

[in] lpwsUserName

Puntatore a una stringa Unicode con terminazione Null che specifica il nome utente.

Questo parametro è facoltativo e, Se l'applicazione chiamante specifica NULL per questo parametro, la funzione non modifica il nome utente associato a questa interfaccia.

[in] lpwsDomainName

Puntatore a una stringa Unicode con terminazione Null che specifica il nome di dominio.

Questo parametro è facoltativo e, Se l'applicazione chiamante specifica NULL per questo parametro, la funzione non modifica il nome di dominio associato a questa interfaccia.

[in] lpwsPassword

Puntatore a una stringa Unicode con terminazione Null che specifica la password.

Questo parametro è facoltativo e, Se l'applicazione chiamante specifica NULL per questo parametro, la funzione non modifica la password associata a questa interfaccia.

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene NO_ERROR.

Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore seguenti.

Valore	Significato
ERROR_INVALID_PARAMETER	Almeno una delle condizioni seguenti è vera: Il parametro lpwsInterfaceName è NULL oppure è più lungo di MAX_INTERFACE_NAME_LEN. Almeno uno dei parametri lpwsUserName, lpwsPassword e lpwsDomainName è troppo lungo e pertanto non è valido. Per altre informazioni, vedere la sezione Osservazioni.
ERROR_NOT_ENOUGH_MEMORY	Memoria insufficiente per creare una nuova struttura di dati per contenere le credenziali.
Altri	Usare FormatMessage per recuperare il messaggio di errore di sistema corrispondente al codice di errore restituito.

Commenti

I parametri lpwsUserName, lpwsPassword e lpwsDomainName sono facoltativi. Se l'applicazione chiamante specifica NULL per tutti e tre i parametri, MprAdminInterfaceSetCredentials rimuove tutte le informazioni sulle credenziali per questa interfaccia.

Le costanti UNLEN, PWLEN e DNLEN sono le lunghezze massime per il nome utente, la password e il nome di dominio. Queste costanti sono definite in Lmcons.h.

Si noti che l'ordine dei parametri in MprAdminInterfaceSetCredentials è diverso da MprAdminInterfaceGetCredentials.

Requisiti


Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	mprapi.h
Libreria	Mprapi.lib
DLL	Mprapi.dll