Funzione AcxObjectBagRetrieveGuid (acxmisc.h)
La funzione AcxObjectBagRetrieveGuid recupera un valore GUID da un oggetto AcxObjectBag esistente che contiene valori.
Sintassi
NTSTATUS AcxObjectBagRetrieveGuid(
ACXOBJECTBAG ObjectBag,
PCUNICODE_STRING ValueName,
GUID *Value
);
Parametri
ObjectBag
Oggetto ObjectBag ACX inizializzato. Per altre informazioni, vedere ACX - Riepilogo degli oggetti ACX.
ValueName
Nome del valore che verrà usato per accedere al valore.
Value
Valore GUID da recuperare da ObjectBag.
Valore restituito
Restituisce STATUS_SUCCESS se la chiamata ha avuto esito positivo. In caso contrario, restituisce un codice di errore appropriato. Per altre informazioni, vedere Uso dei valori NTSTATUS.
Commenti
Esempio
In questo esempio viene illustrato l'uso di 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));
Requisiti ACX
Versione minima DI ACX: 1.0
Per altre informazioni sulle versioni ACX, vedere Panoramica della versione di ACX.
Requisiti
| Requisito | Valore |
|---|---|
| Intestazione | acxmisc.h |
| IRQL | PASSIVE_LEVEL |