Condividi tramite

Funzione AcxObjectBagRetrieveString (acxmisc.h)

  • Articolo

La funzione AcxObjectBagRetrieveString recupera un oggetto WDFSTRING da un oggetto AcxObjectBag esistente inizializzato.

Sintassi

NTSTATUS AcxObjectBagRetrieveString(
  ACXOBJECTBAG     ObjectBag,
  PCUNICODE_STRING ValueName,
  WDFSTRING        Value
);

Parametri

ObjectBag

Oggetto ObjectBag ACX inizializzato. Per altre informazioni, vedere ACX - Riepilogo degli oggetti ACX.

ValueName

ValoreName associato alla stringa aggiunta e verrà usato per recuperare la stringa archiviata.

Value

Valore dell'oggetto WDFSTRING 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 AcxObjectBagRetrieveString.

    status = RtlUnicodeStringInit(&usName, inParams->ValueName);
    if (!NT_SUCCESS(status))
    {
        DrvLogError(g_RecorderLog, FLAG_DDI, 
                    "WDFDEVICE %p, RtlUnicodeStringInit(%S) failed, %!STATUS!", 
                    m_Device, inParams->ValueName, status);
        goto exit;
    }

    //
    // Set the specified property.
    //
    switch(inParams->ValueType)
    {
    case REG_SZ:
        //
        // Create an empty WDF string to get the value.
        //
        status = WdfStringCreate(nullptr, nullptr, &wsValue);
        if (!NT_SUCCESS(status))
        {
            DrvLogError(g_RecorderLog, FLAG_DDI, 
                        "WDFDEVICE %p, WdfStringCreate failed, %!STATUS!", 
                        m_Device, status);
            goto exit;
        }

        //
        // Get the string value from bag.
        //
        status = AcxObjectBagRetrieveString(objBag, &usName, wsValue);

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