Функция PktMonClntSetComponentProperty (pktmonclntk.h)

Функция PktMonClntSetComponentProperty задает свойство для определенного компонента.

Синтаксис

NTSTATUS PktMonClntSetComponentProperty(
  PKTMON_COMPONENT_CONTEXT  *CompContext,
  PKTMON_COMPONENT_PROPERTY *CompProperty
);

Параметры

CompContext

Указатель на структуру PKTMON_COMPONENT_CONTEXT , содержащую контекст для компонента.

CompProperty

Указатель на структуру PKTMON_COMPONENT_PROPERTY , описывающую заданное свойство.

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

Если функция успешно выполнена, она возвращается STATUS_SUCCESS. В противном случае возвращается NTSTATUS код ошибки.

Замечания

Используйте функцию PktMonClntSetComponentProperty , чтобы задать различные свойства компонента. Вызовите эту функцию один раз для каждого свойства. Эти свойства предоставляют подробные сведения о компоненте, например идентификаторе интерфейса, имени и т. д. Свойства компонентов можно отобразить с помощью pktmon команды:

Pktmon.exe list -a

Свойства определяются в структуре PKTMON_COMPONENT_PROPERTY и могут включать индексы интерфейсов, идентификаторы GUID, MAC-адреса и другие важные сведения. Каждое свойство определяется идентификатором из перечисления PKTMON_COMPONENT_PROPERTY_ID .

Требования

См. также

• PKTMON_COMPONENT_CONTEXT
• PKTMON_COMPONENT_PROPERTY

Пример

NTSTATUS PktMonApiTstSetComponentProperties()
{
    NTSTATUS status = STATUS_SUCCESS;
    PKTMON_COMPONENT_PROPERTY compProp = {0};

    compProp.Id = PktMonCompProp_IfIndex;
    compProp.IfIndex = 100;
    status = PktMonClntSetComponentProperty(&PktMonComp, &compProp);
    if (STATUS_SUCCESS != status)
    {
        // Log error
        return status;
    }

    return status;
}