COUNTED_REASON_CONTEXT 구조체(ntpoapi.h)
COUNTED_REASON_CONTEXT 구조에는 전원 요청에 대한 이유를 제공하는 하나 이상의 문자열이 포함되어 있습니다.
구문
typedef struct _COUNTED_REASON_CONTEXT {
ULONG Version;
ULONG Flags;
union {
struct {
UNICODE_STRING ResourceFileName;
USHORT ResourceReasonId;
ULONG StringCount;
PUNICODE_STRING ReasonStrings;
} DUMMYSTRUCTNAME;
UNICODE_STRING SimpleString;
} DUMMYUNIONNAME;
} COUNTED_REASON_CONTEXT, *PCOUNTED_REASON_CONTEXT;
멤버
Version
구조체의 버전 번호입니다. 이 멤버를 DIAGNOSTIC_REASON_VERSION 설정합니다.
Flags
구조체에 간단한 이유 문자열 또는 자세한 이유 문자열 집합이 포함되어 있는지 여부를 나타냅니다. 이 멤버를 다음 상수 중 하나로 설정합니다.
- DIAGNOSTIC_REASON_SIMPLE_STRING
- DIAGNOSTIC_REASON_DETAILED_STRING
DUMMYUNIONNAME
DUMMYUNIONNAME.DUMMYSTRUCTNAME
DUMMYUNIONNAME.DUMMYSTRUCTNAME.ResourceFileName
리소스 파일의 경로 이름을 포함하는 null로 끝나는 와이드 문자열에 대한 포인터입니다. 이 리소스 파일에는 전원 요청에 대한 이유를 제공하는 하나 이상의 지역화된 문자열이 포함되어 있습니다. 이 멤버는 선택 사항이며 필요한 리소스 파일이 없는 경우 NULL 또는 빈 문자열로 지정할 수 있습니다. 이 멤버는 Flags = DIAGNOSTIC_REASON_DETAILED_STRING 경우에만 유효합니다.
DUMMYUNIONNAME.DUMMYSTRUCTNAME.ResourceReasonId
ResourceFileName으로 지정된 리소스 파일의 첫 번째 이유 문자열에 할당된 리소스 ID입니다. 이 멤버는 Flags = DIAGNOSTIC_REASON_DETAILED_STRING 경우에만 유효합니다.
DUMMYUNIONNAME.DUMMYSTRUCTNAME.StringCount
ReasonStrings 배열 또는 ResourceFileName으로 지정된 리소스 파일의 이유 문자열 수입니다. 이 멤버는 Flags = DIAGNOSTIC_REASON_DETAILED_STRING 경우에만 유효합니다.
DUMMYUNIONNAME.DUMMYSTRUCTNAME.ReasonStrings
문자열 포인터 배열에 대한 포인터입니다. 각 배열 요소는 null로 끝나는 와이드 문자열에 대한 포인터입니다. 배열 요소의 수는 StringCount로 지정됩니다. 이 멤버는 Flags = DIAGNOSTIC_REASON_DETAILED_STRING 경우에만 유효합니다.
DUMMYUNIONNAME.SimpleString
전원 요청의 이유를 설명하는 null로 끝나는 와이드 문자 문자열에 대한 포인터입니다. 이 멤버는 Flags = DIAGNOSTIC_REASON_SIMPLE_STRING 경우에만 유효합니다.
설명
이 구조체는 PoCreatePowerRequest 루틴에서 사용됩니다.
전원 관리자는 기능 및 성능 테스트 중에 이 구조에 포함된 이유 문자열 또는 문자열을 진단 지원으로 사용합니다.
COUNTED_REASON_CONTEXT 구조체에는 간단한 이유 문자열 또는 자세한 이유 문자열 집합이 포함될 수 있습니다. Flags = DIAGNOSTIC_REASON_SIMPLE_STRING 경우 SimpleString 멤버는 전원 요청 이유를 설명하는 문자열을 가리킵니다. Flags = DIAGNOSTIC_REASON_DETAILED_STRING 경우 ResourceFileName, ResourceReasonId, StringCount 및 ReasonStrings 멤버는 전원 요청에 대한 자세한 이유 집합을 제공할 수 있습니다.
DIAGNOSTIC_REASON_DETAILED_STRING 플래그는 지역화를 지원합니다. ResourceFileName으로 지정된 지역화된 리소스 파일이 있는 경우 Power Manager는 파일에서 ResourceReasonId로 지정된 리소스 문자열을 검색한 다음 문자열의 형식을 지정하여 , %2등을 바꿉%1니다. ReasonStrings 배열의 해당 항목이 있는 자리 표시자입니다. FormatMessageW와 함께 사용되는 다른 형식 지정자는 지원되지 않습니다.
전원 관리자는 STRINGTABLE 리소스에서 리소스 문자열을 검색합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 7 이상 버전의 Windows 운영 체제에서 지원됩니다. |
| 머리글 | ntpoapi.h(Wdm.h, Ntddk.h, Ntifs.h, Ntpoapi.h 포함) |