Функция TdhGetWppProperty (tdh.h)

Статья
03/02/2024

Извлекает определенное свойство, связанное с сообщением WPP.

Синтаксис

TDHSTATUS TdhGetWppProperty(
  [in]      TDH_HANDLE    Handle,
  [in]      PEVENT_RECORD EventRecord,
  [in]      PWSTR         PropertyName,
  [in, out] PULONG        BufferSize,
  [out]     PBYTE         Buffer
);

Параметры

[in] Handle

Тип: TDH_HANDLE

Допустимый декодирования декодирования.

[in] EventRecord

Тип: PEVENT_RECORD

Запись события, переданная обратному вызову EventRecordCallback .

[in] PropertyName

Тип: PWSTR

Имя свойства, которое необходимо извлечь.

Список возможных значений см. в разделе PROPERTY_DATA_DESCRIPTOR.

[in, out] BufferSize

Тип: PULONG

Размер параметра Buffer в байтах.

[out] Buffer

Тип: PBYTE

Выделенный пользователем буфер, который получает данные свойства.

Возвращаемое значение

Тип: ULONG

В случае успешного выполнения возвращает ERROR_SUCCESS. В противном случае эта функция возвращает один из следующих кодов возврата в дополнение к другим.

Код возврата	Описание
ERROR_NOT_FOUND	Указанное свойство не найдено.
ERROR_INSUFFICIENT_BUFFER	BufferSize слишком мал. Чтобы получить требуемый размер буфера, вызовите TdhGetWppProperty дважды, один раз с пустым буфером и указателем, чтобы получить размер буфера, а затем снова с буфером правильного размера.
ERROR_INVALID_PARAMETER	Один или несколько параметров неверны. Эта ошибка возвращается, если параметр Handle, EventRecord, PropertyName или Buffer имеет значение NULL.

Требования

Требование	Значение
Минимальная версия клиента	Windows 8 [только классические приложения]
Минимальная версия сервера	Windows Server 2012 [только классические приложения]
Целевая платформа	Windows
Header	tdh.h
Библиотека	Tdh.lib
DLL	Tdh.dll

См. также раздел

Поделиться через