NetConfigurationAssignUnicodeString 함수(netconfiguration.h)

NetConfigurationAssignUnicodeString 함수는 레지스트리의 지정된 값 이름에 지정된 유니코드 문자열을 할당합니다.

통사론

NTSTATUS NetConfigurationAssignUnicodeString(
  [_In_] NETCONFIGURATION Configuration,
  [_In_] PCUNICODE_STRING ValueName,
  [_In_] PCUNICODE_STRING Value
);

매개 변수

[_In_] Configuration

열린 레지스트리 키를 나타내는 NETCONFIGURATION 개체에 대한 핸들입니다.

[_In_] ValueName

값 이름을 포함하는 UNICODE_STRING 구조체에 대한 포인터입니다.

[_In_] Value

ValueName 지정하는 값 이름에 할당할 문자열을 포함하는 UNICODE_STRING 구조체에 포인터입니다.

반환 값

이 함수는 작업이 성공하면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 이 함수는 적절한 NTSTATUS 오류 코드를 반환할 수 있습니다.

발언

클라이언트 드라이버는 NetAdapterOpenConfiguration 호출하거나 NetConfigurationOpenSubConfiguration NETCONFIGURATION 개체에 대한 핸들을 가져옵니다.

열려 있는 레지스트리 키 아래에 ValueName 같은 이름의 항목이 이미 있는 경우 NetConfigurationAssignUnicodeString 현재 값을 호출자가 제공한 값으로 바꿉니다. 그렇지 않으면 NetConfigurationAssignUnicodeString 지정된 이름과 제공된 값을 가진 새 값 항목을 레지스트리에 추가합니다.

요구 사항

요구	값
대상 플랫폼	보편적
최소 KMDF 버전	1.21
최소 UMDF 버전	2.33
헤더	netconfiguration.h(netadaptercx.h 포함)
IRQL	PASSIVE_LEVEL