AcxObjectBagRetrieveUnicodeString 함수(acxmisc.h)
AcxObjectBagRetrieveUnicodeString 함수는 값을 포함하는 초기화된 기존 AcxObjectBag에서 유니코드 문자열 값을 검색합니다.
구문
NTSTATUS AcxObjectBagRetrieveUnicodeString(
ACXOBJECTBAG ObjectBag,
PCUNICODE_STRING ValueName,
PUNICODE_STRING Value
);
매개 변수
ObjectBag
초기화된 ObjectBag ACX 개체입니다. 자세한 내용은 ACX - ACX 개체 요약을 참조하세요.
ValueName
값에 액세스하는 데 사용할 값의 이름입니다.
Value
ObjectBag에서 검색할 값입니다.
반환 값
호출에 성공하면 를 반환합니다 STATUS_SUCCESS . 그렇지 않으면 적절한 오류 코드를 반환합니다. 자세한 내용은 NTSTATUS 값 사용을 참조하세요.
설명
예제
이 예제에서는 AcxObjectBagRetrieveUnicodeString을 사용하는 방법을 보여줍니다.
UNICODE_STRING unicodeStringValue;
ACX_OBJECTBAG_CONFIG objBagCfg;
DECLARE_CONST_ACXOBJECTBAG_SYSTEM_PROPERTY_NAME(testName);
ACX_OBJECTBAG_CONFIG_INIT(&objBagCfg);
objBagCfg.Handle = CircuitConfig->CompositeProperties;
objBagCfg.Flags |= AcxObjectBagConfigOpenWithHandle;
WDF_OBJECT_ATTRIBUTES_INIT(&attributes);
ACXOBJECTBAG objBag = NULL;
RETURN_NTSTATUS_IF_FAILED(AcxObjectBagOpen(&attributes, &objBagCfg, &objBag));
auto objBag_free = scope_exit([&objBag]() {
WdfObjectDelete(objBag);
});
RETURN_NTSTATUS_IF_FAILED(AcxObjectBagRetrieveUnicodeString(objBag, &testName, &unicodeStringValue));
ACX 요구 사항
최소 ACX 버전: 1.0
ACX 버전에 대한 자세한 내용은 ACX 버전 개요를 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 헤더 | acxmisc.h |
| IRQL | PASSIVE_LEVEL |