Funzione NPGetUser (npapi.h)

  • Articolo

Recupera il valore del nome utente predefinito corrente o del nome utente usato per stabilire una connessione di rete.

Sintassi

DWORD NPGetUser(
  [in]      LPWSTR  lpName,
  [out]     LPWSTR  lpUserName,
  [in, out] LPDWORD lpnBufferLen
);

Parametri

[in] lpName

Puntatore al nome del dispositivo locale a cui il chiamante è interessato o un nome remoto per una risorsa a cui l'utente ha effettuato una connessione. Questo parametro può essere NULL o la stringa vuota se il chiamante è interessato al nome dell'utente attualmente connesso al sistema. Se viene passato un nome remoto per una risorsa e l'utente è connesso a tale risorsa usando nomi diversi, è possibile che un provider non possa risolvere il nome utente da restituire. In questo caso, il provider può fare una scelta arbitraria tra i possibili nomi utente.

[out] lpUserName

Puntatore a un buffer per ricevere il nome utente. Questo deve essere un nome che può essere passato alla funzione NPAddConnection o NPAddConnection3 per ristabilire la connessione con lo stesso nome utente.

[in, out] lpnBufferLen

Puntatore alle dimensioni, in caratteri, del buffer lpUserName . Se la chiamata ha esito negativo perché il buffer non è abbastanza grande, questa posizione verrà usata per restituire le dimensioni del buffer necessarie.

Valore restituito

Se la funzione ha esito positivo, deve restituire WN_SUCCESS. In caso contrario, deve restituire un codice di errore, che può essere uno dei seguenti.

Codice restituito Descrizione
WN_NOT_CONNECTED
 Il valore nel parametro lpName non è il nome di un dispositivo reindirizzato o di un nome remoto connesso.
WN_MORE_DATA
 Il buffer, lpUserName, è troppo piccolo.
WN_NO_NETWORK
 La rete non è presente.

Requisiti

Requisito Valore
Client minimo supportato Windows XP [solo app desktop]
Server minimo supportato Windows Server 2003 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione npapi.h