NetConfigurationAssignBinary, fonction (netconfiguration.h)

Article
05/23/2024

La fonction NetConfigurationAssignBinary écrit les données binaires fournies par l’appelant dans un nom de valeur spécifié dans le Registre.

Syntaxe

NTSTATUS NetConfigurationAssignBinary(
  [_In_]                             NETCONFIGURATION Configuration,
  [_In_]                             PCUNICODE_STRING ValueName,
  [__In_reads_bytes_(BufferLength)_] void             *Buffer,
  [_In_]                             ULONG            BufferLength
);

Paramètres

[_In_] Configuration

Handle d’un objet NETCONFIGURATION qui représente une clé de Registre ouverte.

[_In_] ValueName

Pointeur vers une structure UNICODE_STRING qui contient un nom de valeur.

[__In_reads_bytes_(BufferLength)_] Buffer

Pointeur vers une mémoire tampon qui contient des données fournies par le pilote.

[_In_] BufferLength

Longueur, en octets, de la mémoire tampon vers laquelle la mémoire tampon pointe.

Valeur retournée

Cette fonction retourne STATUS_SUCCESS si l’opération réussit. Sinon, cette fonction peut retourner un code d’erreur NTSTATUS approprié.

Remarques

Le pilote client obtient un handle pour un objet NETCONFIGURATION en appelant NetAdapterOpenConfiguration ou NetConfigurationOpenSubConfiguration.

Si une entrée du même nom que ValueName existe déjà sous la clé de Registre ouverte, NetConfigurationAssignBinary remplace sa valeur actuelle par la valeur fournie par l’appelant. Sinon, NetConfigurationAssignBinary ajoute une nouvelle entrée de valeur avec le nom donné et la valeur fournie au Registre.

Configuration requise

Condition requise	Valeur
Plateforme cible	Universal
Version KMDF minimale	1.21
Version UMDF minimale	2,33
En-tête	netconfiguration.h (inclure netadaptercx.h)
IRQL	PASSIVE_LEVEL

Partager via