Funzione NPGetUser (npapi.h)

Recupera il valore del nome utente predefinito corrente o del nome utente utilizzato 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ò effettuare una scelta arbitraria tra i possibili nomi utente.

[out] lpUserName

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

[in, out] lpnBufferLen

Puntatore alla dimensione, in caratteri, del buffer lpUserName . Se la chiamata non riesce perché il buffer non è sufficientemente 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	Description
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	Value
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Header	npapi.h
Library	davclnt.lib