acxObjectBagRetrieveGuid 函数 (acxmisc.h)

重要

某些信息与预发行产品有关,该产品在商业发布之前可能会进行大幅修改。 Microsoft 不对此处提供的信息作任何明示或默示的担保。

AcxObjectBagRetrieveGuid 函数从包含值的现有初始化 AcxObjectBag 中检索 GUID 值。

语法

NTSTATUS AcxObjectBagRetrieveGuid(
  ACXOBJECTBAG     ObjectBag,
  PCUNICODE_STRING ValueName,
  GUID             *Value
);

参数

ObjectBag

初始化的 ObjectBag ACX 对象。 有关详细信息,请参阅 ACX - ACX 对象的摘要

ValueName

将用于访问该值的值的名称。

Value

要从 ObjectBag 检索的 GUID 值。

返回值

如果调用成功,则返回 STATUS_SUCCESS 。 否则,它将返回适当的错误代码。 有关详细信息,请参阅 使用 NTSTATUS 值

备注

示例

此示例演示 AcxObjectBagRetrieveGuid 的使用。

        GUID                    uniqueId = { 0 };
        UNICODE_STRING          uniqueIdStr = { 0 };
        UNICODE_STRING          pnpDeviceId = { 0 };
        ACX_OBJECTBAG_CONFIG    objBagCfg;

        DECLARE_CONST_ACXOBJECTBAG_SYSTEM_PROPERTY_NAME(UniqueID);

        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(AcxObjectBagRetrieveGuid(objBag, &UniqueID, &uniqueId));

要求

   
标头 acxmisc.h

另请参阅