Fonction AddLocalAlternateComputerName

Article
06/13/2023

Ajoute un autre nom de réseau local pour l’ordinateur à partir duquel il est appelé.

Syntaxe

DWORD AddLocalAlternateComputerName(
  _In_ LPCTSTR lpDnsFQHostname,
  _In_ ULONG   ulFlags
);

Paramètres

lpDnsFQHostname [in]: Autre nom à ajouter. Le nom doit être au format ComputerNameDnsFullyQualified tel que défini dans l’énumération COMPUTER_NAME_FORMAT , et la fonction DnsValidateName_W doit être en mesure de le valider avec son format défini sur DnsNameHostnameFull.
ulFlags [in]: Ce paramètre est réservé et doit être défini sur zéro.

Valeur retournée

Si la fonction réussit, la fonction retourne ERROR_SUCCESS. Si la fonction échoue, elle retourne un code d’erreur différent de zéro. Parmi les codes d’erreur qu’il retourne sont les suivants :

Code de retour	Description
ERROR_INVALID_PARAMETER	Indique que le paramètre lpDnsFQHostname ne pointe pas vers un nom DNS valide ou que le paramètre ulFlags n’est pas égal à zéro.
ERROR_NOT_ENOUGH_MEMORY	La mémoire disponible est insuffisante pour terminer cette opération.

Spécifications

Condition requise	Valeur
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll
Noms Unicode et ANSI	AddLocalAlternateComputerNameW (Unicode) et AddLocalAlternateComputerNameA (ANSI)

Voir aussi

COMPUTER_NAME_FORMAT
DnsValidateName_W

Partager via