Funzione DnsHostnameToComputerNameA (winbase.h)
Converte un nome host in stile DNS in un nome computer di tipo NetBIOS.
Sintassi
BOOL DnsHostnameToComputerNameA(
[in] LPCSTR Hostname,
[out] LPSTR ComputerName,
[in, out] LPDWORD nSize
);
Parametri
[in] Hostname
Nome DNS. Se il nome DNS non è un nome valido, traducibile, la funzione ha esito negativo. Per altre informazioni, vedere Nomi computer.
[out] ComputerName
Puntatore a un buffer che riceve il nome del computer. Le dimensioni del buffer devono essere sufficienti per contenere MAX_COMPUTERNAME_LENGTH + 1 caratteri.
[in, out] nSize
In input, specifica le dimensioni del buffer, in TCHAR. Nell'output, riceve il numero di TCHAR copiati nel buffer di destinazione, senza includere il carattere null di terminazione.
Se il buffer è troppo piccolo, la funzione ha esito negativo, GetLastError restituisce ERROR_MORE_DATA e nSize riceve le dimensioni del buffer necessarie, senza includere il carattere Null di terminazione.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è un valore diverso da zero.
Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError. Di seguito sono indicati alcuni valori possibili.
| Codice restituito | Descrizione |
|---|---|
|
Il buffer ComputerName è troppo piccolo. Il parametro nSize contiene il numero di byte necessari per ricevere il nome. |
Commenti
Questa funzione esegue un mapping testuale del nome. Questa convenzione limita i nomi dei computer come sottoinsieme comune dei nomi. In particolare, l'etichetta più a sinistra del nome DNS viene troncata a 15 byte di caratteri OEM. Pertanto, non usare questa funzione per convertire un nome di dominio DNS in un nome di dominio NetBIOS. Non esiste alcun mapping testuale per i nomi di dominio.
Per compilare un'applicazione che usa questa funzione, definire _WIN32_WINNT come 0x0500 o versione successiva. Per altre informazioni, vedere Uso delle intestazioni di Windows.
Nota
L'intestazione winbase.h definisce DnsHostnameToComputerName 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 che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.
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 | winbase.h (include Windows.h) |
| Libreria | Kernel32.lib |
| DLL | Kernel32.dll |