AcxObjectBagRetrieveBlob, fonction (acxmisc.h)
La fonction AcxObjectBagRetrieveBlob récupère une valeur d’objet blob à partir d’un AcxObjectBag initialisé existant qui contient des valeurs.
Syntaxe
NTSTATUS AcxObjectBagRetrieveBlob(
ACXOBJECTBAG ObjectBag,
PCUNICODE_STRING ValueName,
PWDF_OBJECT_ATTRIBUTES ValueAttributes,
WDFMEMORY *Value
);
Paramètres
ObjectBag
Objet ACX ObjectBag initialisé. Pour plus d’informations, consultez ACX - Résumé des objets ACX.
ValueName
Nom de la valeur qui sera utilisée pour accéder à la valeur.
ValueAttributes
Facultatif WDF_OBJECT_ATTRIBUTES qui peuvent être utilisés pour définir des ValueAttributes supplémentaires.
Value
Valeur à récupérer à partir de ObjectBag.
Valeur retournée
Retourne STATUS_SUCCESS si l’appel a réussi. Sinon, il retourne un code d’erreur approprié. Pour plus d’informations, consultez Utilisation de valeurs NTSTATUS.
Remarques
Exemple
Cet exemple montre l’utilisation d’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);
Configuration requise d’ACX
Version minimale d’ACX : 1.0
Pour plus d’informations sur les versions d’ACX, consultez Vue d’ensemble des versions d’ACX.
Configuration requise
| Condition requise | Valeur |
|---|---|
| En-tête | acxmisc.h |
| IRQL | AcxObjectBagRetrieveBlob |