SERVICE_TRIGGER_SPECIFIC_DATA_ITEM 구조체(winsvc.h)

서비스 트리거 이벤트에 대한 트리거 관련 데이터를 포함합니다. 이 구조체는 SERVICE_TRIGGER_TYPE_CUSTOM, SERVICE_TRIGGER_TYPE_DEVICE_ARRIVAL , SERVICE_TRIGGER_TYPE_FIREWALL_PORT_EVENT 또는 SERVICE_TRIGGER_TYPE_NETWORK_ENDPOINT 트리거 이벤트에 대한 SERVICE_TRIGGER 구조체에서 사용됩니다.

구문

typedef struct _SERVICE_TRIGGER_SPECIFIC_DATA_ITEM {
  DWORD dwDataType;
  DWORD cbData;
  PBYTE pData;
} SERVICE_TRIGGER_SPECIFIC_DATA_ITEM, *PSERVICE_TRIGGER_SPECIFIC_DATA_ITEM;

멤버

dwDataType

pData가 가리키는 트리거별 데이터의 데이터 형식입니다. 이 멤버는 다음 값 중 하나일 수 있습니다.

값	의미
SERVICE_TRIGGER_DATA_TYPE_BINARY 1	트리거별 데이터는 이진 형식입니다.
SERVICE_TRIGGER_DATA_TYPE_STRING 2	트리거별 데이터는 문자열 형식입니다.
SERVICE_TRIGGER_DATA_TYPE_LEVEL 3	트리거별 데이터는 바이트 값입니다.
SERVICE_TRIGGER_DATA_TYPE_KEYWORD_ANY 4	트리거별 데이터는 64비트 부호 없는 정수 값입니다.
SERVICE_TRIGGER_DATA_TYPE_KEYWORD_ALL 5	트리거별 데이터는 64비트 부호 없는 정수 값입니다.

cbData

pData를 가리키는 트리거별 데이터의 크기(바이트)입니다. 최댓값은 1,024입니다.

pData

서비스 트리거 이벤트에 대한 트리거별 데이터에 대한 포인터입니다. 트리거 관련 데이터는 트리거 이벤트 유형에 따라 달라집니다. 설명을 참조하세요.

dwDataType 멤버가 SERVICE_TRIGGER_DATA_TYPE_BINARY 경우 트리거별 데이터는 바이트 배열입니다.

dwDataType 멤버가 SERVICE_TRIGGER_DATA_TYPE_STRING 경우 트리거별 데이터는 null로 끝나는 문자열 또는 null로 끝나는 문자열의 다중 문자열로, 두 개의 null 종결 문자로 끝납니다. 예: "5001\0UDP\0%programfiles%\MyApplication\MyServiceProcess.exe\0MyService\0\0"

문자열은 유니코드여야 합니다. ANSI 문자열은 지원되지 않습니다.

설명

다음 표에서는 트리거 이벤트 유형별 트리거별 데이터를 나열합니다.

이벤트 유형	트리거별 데이터
SERVICE_TRIGGER_TYPE_CUSTOM	사용자 지정 이벤트를 정의하는 ETW( Windows용 이벤트 추적 ) 공급자에 의해 지정됩니다.
SERVICE_TRIGGER_TYPE_DEVICE_INTERFACE_ARRIVAL	디바이스 인터페이스 클래스에 대한 하드웨어 ID 또는 호환 ID 문자열을 지정하는 SERVICE_TRIGGER_DATA_TYPE_STRING 문자열입니다.
SERVICE_TRIGGER_TYPE_DOMAIN_JOIN	해당 사항 없음
SERVICE_TRIGGER_TYPE_FIREWALL_PORT_EVENT	포트, 프로토콜 및 필요에 따라 이벤트에서 수신 대기하는 서비스의 실행 경로 및 이름을 지정하는 SERVICE_TRIGGER_DATA_TYPE_STRING 다중 문자열입니다.
SERVICE_TRIGGER_TYPE_GROUP_POLICY	해당 사항 없음
SERVICE_TRIGGER_TYPE_IP_ADDRESS_AVAILABILITY	해당 사항 없음
SERVICE_TRIGGER_TYPE_NETWORK_ENDPOINT	네트워크 엔드포인트에 대한 포트, 명명된 파이프 또는 RPC 인터페이스를 지정하는 SERVICE_TRIGGER_DATA_TYPE_STRING.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 7 [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 R2 [데스크톱 앱만 해당]
머리글	winsvc.h

추가 정보

ChangeServiceConfig2

QueryServiceConfig2

SERVICE_TRIGGER

서비스 트리거 이벤트