Função AcxObjectBagAddUnicodeString (acxmisc.h)

Artigo
02/06/2025

A função AcxObjectBagAddUnicodeString adiciona uma cadeia de caracteres unicode ao AcxObjectBag inicializado e existente.

Sintaxe

NTSTATUS AcxObjectBagAddUnicodeString(
  ACXOBJECTBAG     ObjectBag,
  PCUNICODE_STRING ValueName,
  PCUNICODE_STRING Value
);

Parâmetros

ObjectBag

Um objeto ACX do ObjectBag inicializado. Para obter mais informações, consulte ACX – Resumo dos objetos ACX.

ValueName

O nome do valor que será usado para acessar o valor.

Value

O valor UNICODE_STRING a ser adicionado ao ObjectBag.

Valor de retorno

Retorna STATUS_SUCCESS se a chamada foi bem-sucedida. Caso contrário, ele retornará um código de erro apropriado. Para obter mais informações, consulte Usando valores NTSTATUS.

Observações

Exemplo

Este exemplo mostra o uso de AcxObjectBagAddUnicodeString.

    _In_ ACXOBJECTBAG               ObjBag,
    _In_ UNICODE_STRING             FriendlyNameStr,
    _In_ UNICODE_STRING             NameStr
)
{
    PAGED_CODE();

    NTSTATUS status = STATUS_SUCCESS;

    DECLARE_CONST_ACXOBJECTBAG_SYSTEM_PROPERTY_NAME(FriendlyName);
    RETURN_NTSTATUS_IF_FAILED(AcxObjectBagAddUnicodeString(ObjBag, &FriendlyName, &FriendlyNameStr));

Requisitos do ACX

versão mínima do ACX: 1.0

Para obter mais informações sobre versões do ACX, consulte visão geral da versão do ACX.

Requisitos

Requisito	Valor
cabeçalho	acxmisc.h
IRQL	PASSIVE_LEVEL

Consulte também

cabeçalho acxmisc.h

Partilhar via