NetConfigurationAssignBinary 函式 (netconfiguration.h)

NetConfigurationAssignBinary 函式會將呼叫端提供的二進位數據寫入登錄中指定的值名稱。

語法

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

參數

[_In_] Configuration

NETCONFIGURATION 物件的句柄，表示已開啟的登錄機碼。

[_In_] ValueName

包含值名稱 之UNICODE_STRING 結構的指標。

[__In_reads_bytes_(BufferLength)_] Buffer

緩衝區的指標，其中包含驅動程式提供的數據。

[_In_] BufferLength

Buffer 所指向之緩衝區的長度，以位元組為單位。

傳回值

如果作業成功，此函式會傳回STATUS_SUCCESS。 否則，此函式可能會傳回適當的NTSTATUS錯誤碼。

備註

用戶端驅動程式會呼叫 NetAdapterOpenConfiguration 或 NetConfigurationOpenSubConfiguration，以取得 NETCONFIGURATION 物件的句柄。

如果與 ValueName 相同的專案已存在於開啟的登錄機碼底下， NetConfigurationAssignBinary 就會以呼叫端提供的值取代其目前值。 否則， NetConfigurationAssignBinary 會將具有指定名稱和提供值的新值專案新增至登錄。

規格需求