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가 가리키는 트리거별 데이터의 데이터 형식입니다. 이 멤버는 다음 값 중 하나일 수 있습니다.
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 |