Funzione WNetGetProviderNameA (winnetwk.h)

Articolo
11/20/2024

La funzione WNetGetProviderName ottiene il nome del provider per un tipo di rete specifico.

Sintassi

DWORD WNetGetProviderNameA(
  [in]      DWORD   dwNetType,
  [out]     LPSTR   lpProviderName,
  [in, out] LPDWORD lpBufferSize
);

Parametri

[in] dwNetType

Tipo di rete univoco per la rete. Se due reti sostengono lo stesso tipo, la funzione restituisce prima il nome del provider caricato. Viene usata solo la parola alta del tipo di rete. Se una rete segnala un sottotipo nella parola bassa, viene ignorato.

È possibile trovare un elenco completo dei tipi di rete nel file di intestazione Winnetwk.h.

[out] lpProviderName

Puntatore a un buffer che riceve il nome del provider di rete.

[in, out] lpBufferSize

Dimensioni del buffer passato alla funzione, in caratteri. Se il valore restituito è ERROR_MORE_DATA, lpBufferSize restituisce le dimensioni del buffer necessarie (in caratteri) per contenere il nome del provider.

Windows Me/98/95: Dimensioni del buffer in byte, non caratteri. Inoltre, il buffer deve essere di almeno 1 byte.

Valore restituito

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

Se la funzione ha esito negativo, il valore restituito è un codice di errore di sistema , ad esempio uno dei valori seguenti.

Codice restituito	Descrizione
ERROR_MORE_DATA	Il buffer è troppo piccolo per contenere il nome del provider di rete.
ERROR_NO_NETWORK	La rete non è disponibile.
ERROR_INVALID_ADDRESS	Il parametro lpProviderName o il parametro lpBufferSize non è valido.

Osservazioni

Nota

L'intestazione winnetwk.h definisce WNetGetProviderName come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.

Fabbisogno

Requisito	Valore
client minimo supportato	Windows 2000 Professional [solo app desktop]
server minimo supportato	Windows 2000 Server [solo app desktop]
piattaforma di destinazione	Finestre
intestazione	winnetwk.h
libreria	Mpr.lib
dll	Mpr.dll

Vedere anche

WNetGetNetworkInformation

WNetGetResourceInformation

WNetGetUniversalName

Panoramica rete Windows

Funzioni di rete di Windows

Condividi tramite