AcxObjectBagRetrieveString-Funktion (acxmisc.h)
Die AcxObjectBagRetrieveString-Funktion ruft ein WDFSTRING-Objekt aus einem vorhandenen, initialisierten AcxObjectBag-Objekt ab.
Syntax
NTSTATUS AcxObjectBagRetrieveString(
ACXOBJECTBAG ObjectBag,
PCUNICODE_STRING ValueName,
WDFSTRING Value
);
Parameter
ObjectBag
Ein initialisiertes ObjectBag ACX-Objekt. Weitere Informationen finden Sie unter ACX – Zusammenfassung von ACX-Objekten.
ValueName
Ein ValueName, der der hinzugefügten Zeichenfolge zugeordnet wird und zum Abrufen der gespeicherten Zeichenfolge verwendet wird.
Value
Der WDFSTRING-Objektwert, der aus objectBag abgerufen werden soll.
Rückgabewert
Gibt zurück STATUS_SUCCESS , wenn der Aufruf erfolgreich war. Andernfalls wird ein geeigneter Fehlercode zurückgegeben. Weitere Informationen finden Sie unter Verwenden von NTSTATUS-Werten.
Bemerkungen
Beispiel
In diesem Beispiel wird die Verwendung von AcxObjectBagRetrieveString veranschaulicht.
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);
ACX-Anforderungen
ACX-Mindestversion: 1.0
Weitere Informationen zu ACX-Versionen finden Sie unter ACX-Versionsübersicht.
Anforderungen
| Anforderung | Wert |
|---|---|
| Header | acxmisc.h |
| IRQL | PASSIVE_LEVEL |