Funzione MprAdminInterfaceGetCredentials (mprapi.h)
Usare la funzione MprAdminInterfaceGetCredentials per recuperare il dominio, il nome utente e la password per la connessione remota nell'interfaccia richiesta specificata.
Sintassi
DWORD MprAdminInterfaceGetCredentials(
[in] LPWSTR lpwsServer,
[in] LPWSTR lpwsInterfaceName,
[out] LPWSTR lpwsUserName,
[out] LPWSTR lpwsPassword,
[out] LPWSTR lpwsDomainName
);
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 chiamata richiesta. Usare MprAdminInterfaceGetInfo per ottenere il nome dell'interfaccia.
[out] lpwsUserName
Puntatore a una stringa Unicode che riceve il nome dell'utente. Questa stringa deve essere UNLEN+1 long.
Questo parametro è facoltativo e, Se l'applicazione chiamante specifica NULL per questo parametro, la funzione non restituisce il nome utente.
[out] lpwsPassword
Puntatore a una stringa Unicode che riceve la password. Questa stringa deve essere PWLEN+1 long.
Questo parametro è facoltativo e, Se l'applicazione chiamante specifica NULL per questo parametro, la funzione non restituisce la password.
[out] lpwsDomainName
Puntatore a una stringa Unicode che riceve il nome di dominio. Questa stringa deve essere DNLEN+1 long.
Questo parametro è facoltativo e, Se l'applicazione chiamante specifica NULL per questo parametro, la funzione non restituisce il nome di dominio.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è NO_ERROR.
Se la funzione ha esito negativo, il valore restituito è uno dei codici di errore seguenti.
| Valore | Significato |
|---|---|
|
L'interfaccia specificata non dispone di parametri di composizione richiesta associati. |
|
Il parametro lpwsInterfaceName è NULL. |
|
I parametri lpwsUserName, lpwsPassword e lpwsDomainName sono tutti NULL. |
|
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, MprAdminInterfaceGetCredentials restituisce NO_ERROR e il dominio, il nome utente e la password non vengono restituiti.
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 MprAdminInterfaceGetCredentials è diverso da MprAdminInterfaceSetCredentials.
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 |
Vedi anche
MprAdminInterfaceSetCredentials