Función AcxObjectBagRetrieveBlob (acxmisc.h)

La función AcxObjectBagRetrieveBlob recupera un valor de blob de un AcxObjectBag inicializado existente que contiene valores.

Sintaxis

NTSTATUS AcxObjectBagRetrieveBlob(
  ACXOBJECTBAG           ObjectBag,
  PCUNICODE_STRING       ValueName,
  PWDF_OBJECT_ATTRIBUTES ValueAttributes,
  WDFMEMORY              *Value
);

Parámetros

ObjectBag

Objeto ACX inicializado ObjectBag. Para obtener más información, vea ACX - Resumen de objetos ACX.

ValueName

Nombre del valor que se usará para tener acceso al valor.

ValueAttributes

WDF_OBJECT_ATTRIBUTES opcional que se puede usar para definir valores ValueAttributes adicionales.

Value

Valor que se va a recuperar de ObjectBag.

Valor devuelto

Devuelve STATUS_SUCCESS si la llamada se realizó correctamente. De lo contrario, devuelve un código de error adecuado. Para obtener más información, vea Using NTSTATUS Values.

Observaciones

Ejemplo

En este ejemplo se muestra el uso de AcxObjectBagRetrieveBlob.

    WDFMEMORY vendorPropertiesBlock = NULL;
    PVOID vendorPropertiesBuffer = NULL;
    size_t vendorPropertiesSize = 0;
    NTSTATUS status = STATUS_NOT_FOUND;

    PAGED_CODE();

    //
    // Retrieve the vendor blob from the CircuitProperties object bag.
    //
    RETURN_NTSTATUS_IF_FAILED(AcxObjectBagRetrieveBlob(CircuitProperties, &VendorPropertiesBlock, NULL, &vendorPropertiesBlock));

    vendorPropertiesBuffer = WdfMemoryGetBuffer(vendorPropertiesBlock, &vendorPropertiesSize);

Requisitos de ACX

versión mínima de ACX: 1.0

Para obtener más información sobre las versiones de ACX, consulte introducción a la versión de ACX.

Requisitos

Consulte también

• encabezado acxmisc.h