acxObjectBagRetrieveSizeT 函式 (acxmisc.h)

重要

有些資訊與發行前版本產品有關,在正式發行前可能會大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。

AcxObjectBagRetrieveSizeT 函式會從現有的初始化 AcxObjectBag 擷取SIZE_T值。

語法

NTSTATUS AcxObjectBagRetrieveSizeT(
  ACXOBJECTBAG     ObjectBag,
  PCUNICODE_STRING ValueName,
  size_t           *Value
);

參數

ObjectBag

初始化的 ObjectBag ACX 物件。 如需詳細資訊,請參閱 ACX - ACX 物件的摘要

ValueName

將用來存取值的值名稱。

Value

要從 ObjectBag 擷取的值。

傳回值

如果呼叫成功,則傳 STATUS_SUCCESS 回 。 否則,它會傳回適當的錯誤碼。 如需詳細資訊,請參閱 使用 NTSTATUS 值

備註

範例

        SIZE_T                  sizeValue = 0;
        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(AcxObjectBagRetrieveSizeT(objBag, &TestName, &sizeValue));

規格需求

   
標頭 acxmisc.h

另請參閱