Funzione AcxObjectBagRetrieveUnicodeString (acxmisc.h)
La funzione AcxObjectBagRetrieveUnicodeString recupera un valore stringa Unicode da un oggetto AcxObjectBag inizializzato esistente che contiene valori.
Sintassi
NTSTATUS AcxObjectBagRetrieveUnicodeString(
ACXOBJECTBAG ObjectBag,
PCUNICODE_STRING ValueName,
PUNICODE_STRING Value
);
Parametri
ObjectBag
Oggetto ACX ObjectBag inizializzato. Per altre informazioni, vedere ACX - Riepilogo degli oggetti ACX.
ValueName
Nome del valore che verrà utilizzato per accedere al valore.
Value
Valore 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 di valori NTSTATUS.
Osservazioni
Esempio
Questo esempio illustra l'uso di AcxObjectBagRetrieveUnicodeString.
UNICODE_STRING unicodeStringValue;
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(AcxObjectBagRetrieveUnicodeString(objBag, &testName, &unicodeStringValue));
Requisiti ACX
versione minima di ACX: 1.0
Per altre informazioni sulle versioni di ACX, vedere panoramica della versione ACX.
Fabbisogno
| Requisito | Valore |
|---|---|
| intestazione | acxmisc.h |
| IRQL | PASSIVE_LEVEL |