Condividi tramite

Funzione AcxObjectBagRetrieveGuid (acxmisc.h)

  • Articolo

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

Vedi anche