Funzione NetConfigurationAssignBinary (netconfiguration.h)

  • Articolo

La funzione NetConfigurationAssignBinary scrive i dati binari forniti dal chiamante in un nome di valore specificato nel Registro di sistema.

Sintassi

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

Parametri

[_In_] Configuration

Handle per un oggetto NETCONFIGURATION che rappresenta una chiave del Registro di sistema aperta.

[_In_] ValueName

Puntatore a una struttura UNICODE_STRING contenente un nome di valore.

[__In_reads_bytes_(BufferLength)_] Buffer

Puntatore a un buffer contenente i dati forniti dal driver.

[_In_] BufferLength

Lunghezza, in byte, del buffer a cui punta buffer .

Valore restituito

Questa funzione restituisce STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, questa funzione può restituire un codice di errore NTSTATUS appropriato.

Commenti

Il driver client ottiene un handle a un oggetto NETCONFIGURATION chiamando NetAdapterOpenConfiguration o NetConfigurationOpenSubConfiguration.

Se una voce dello stesso nome di ValueName esiste già nella chiave del Registro di sistema aperta, NetConfigurationAssignBinary sostituisce il relativo valore corrente con il valore fornito dal chiamante. In caso contrario, NetConfigurationAssignBinary aggiunge una nuova voce di valore con il nome specificato e fornito al Registro di sistema.

Requisiti

Requisito Valore
Piattaforma di destinazione Universale
Versione KMDF minima 1.21
Intestazione netconfiguration.h (include netadaptercx.h)
IRQL PASSIVE_LEVEL