Funzione GetNameByTypeA (nspapi.h)

  • Articolo

La funzione GetNameByType recupera il nome di un servizio di rete per il tipo di servizio specificato.

Nota La funzione GetNameByType è un'estensione specifica di Microsoft per la specifica Windows Sockets 1.1. questa funzione è obsoleta. Per praticità degli sviluppatori di Windows Sockets 1.1, il materiale di riferimento è il seguente.
 
Nota Le funzioni dettagliate nella risoluzione dei nomi indipendenti dal protocollo forniscono funzionalità equivalenti in Windows Sockets 2.
 

Sintassi

INT GetNameByTypeA(
  [in]  LPGUID lpServiceType,
  [out] LPSTR  lpServiceName,
  [in]  DWORD  dwNameLength
);

Parametri

[in] lpServiceType

Puntatore a un identificatore univoco globale (GUID) che specifica il tipo del servizio di rete. Il file di intestazione Svcguid.h include definizioni di diversi tipi di servizio GUID e macro per usarli.

Il file di intestazione Svcguid.h non viene automaticamente incluso dal file di intestazione Winsock2.h .

[out] lpServiceName

Puntatore a un buffer per ricevere una stringa con terminazione zero che rappresenta in modo univoco il nome del servizio di rete.

[in] dwNameLength

Puntatore a una variabile che, in input, specifica le dimensioni, in byte, del buffer a cui punta lpServiceName. In output, la variabile contiene le dimensioni effettive della stringa del nome del servizio, in byte.

Valore restituito

Se la funzione ha esito positivo, il valore restituito non è SOCKET_ERROR (-1).

Se la funzione ha esito negativo, il valore restituito è SOCKET_ERROR (–1). Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Nota

L'intestazione nspapi.h definisce GetNameByType come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione nspapi.h
Libreria Mswsock.lib
DLL Mswsock.dll

Vedi anche

GetTypeByName

Funzioni Winsock

Informazioni di riferimento su Winsock