RpcErrorGetNextRecord 함수(rpcasync.h)
RpcErrorGetNextRecord 함수는 열거형 핸들에 대한 다음 확장 오류 정보 레코드를 검색합니다.
구문
RPC_STATUS RpcErrorGetNextRecord(
[in] RPC_ERROR_ENUM_HANDLE *EnumHandle,
[in] BOOL CopyStrings,
[out] RPC_EXTENDED_ERROR_INFO *ErrorInfo
);
매개 변수
[in] EnumHandle
RPC_ERROR_ENUM_HANDLE 구조체 형식의 열거형 핸들에 대한 포인터입니다. 구조체는 호출자가 할당해야 하며 작업이 완료될 때까지 해제할 수 없습니다. 모든 멤버는 입력에서 무시됩니다.
[in] CopyStrings
ErrorInfo의 문자열 필드를 기본 시스템 힙에 복사할지 여부를 지정합니다. 이때 해당 버퍼의 소유권이 호출자에게 전송됩니다.
TRUE는 문자열을 시스템 힙에 복사해야 했음을 나타냅니다.
FALSE는 ErrorInfo 의 문자열이 내부 RPC 데이터 구조를 가리키고, 호출자는 해제하거나 쓸 수 없으며 RpcErrorEndEnumeration 함수가 호출되면 유효하지 않습니다.
[out] ErrorInfo
RPC_EXTENDED_ERROR_INFO 구조체에 대한 포인터입니다. 설명 부분을 참조하세요.
반환 값
CopyStrings가 false이면 매개 변수가 유효하지 않으면 함수 호출이 실패할 수 없습니다. 마지막 확장 오류 레코드가 검색되면 RpcErrorGetNextRecord 는 RPC_S_OK 반환합니다. 후속 호출은 RPC_S_ENTRY_NOT_FOUND 반환합니다.
오류가 발생하면 열거형 위치가 고급 상태가 아닙니다.
참고 유효한 오류 코드 목록은 RPC 반환 값을 참조하세요.
설명
입력 시 ErrorInfo에서 다음 필드를 설정해야 합니다.
- 버전을 RPC_EEINFO_VERSION 설정해야 합니다.
- NumberOfParameters는 0과 MaxNumberOfEEInfoParams 사이의 값으로 설정해야 합니다. 호출자는 다양한 매개 변수에 대한 공간을 자유롭게 제공할 수 있습니다. 호출자가 제공하는 매개 변수 수가 확장 오류 레코드의 매개 변수 수보다 작으면 RPC_S_BUFFER_TOO_SMALL 반환됩니다.
- 플래그 는 0이거나 EEInfoUseFileTime 을 지정해야 합니다. Flags가 0이면 u 공용 구조체의 SystemTime 멤버가 사용됩니다. EEInfoUseFileTime을 지정하면 u 공용 구조체의 FileTime 멤버가 사용됩니다.
출력 시 ErrorInfo 의 필드는 다음과 같이 채워집니다.
- 버전은 변경되지 않습니다.
- ComputerName 은 레코드에 컴퓨터 이름이 없는 경우 NULL 이거나 확장된 오류 정보 레코드에 컴퓨터 이름이 있는 경우 유니코드 문자열입니다. NULL인 경우 컴퓨터 이름을 가진 마지막 레코드를 가정할 수 있지만 메모리 부족으로 컴퓨터 이름이 삭제되었을 수 있습니다. ComputerName 은 정규화되지 않은 DNS 이름입니다.
- ProcessID 는 레코드가 시작된 프로세스의 PID입니다.
- SystemTime 또는 FileTime 은 레코드가 생성된 컴퓨터에 대해 UCT로 표현된 레코드가 생성된 시간입니다. FileTime 또는 SystemTime은 EEInfoUseFileTime이 사용되는지 여부에 따라 유효합니다.
- GeneratingComponent 는 생성 구성 요소에 대한 코드입니다.
- 상태는 레코드의 상태 코드입니다.
- DetectionLocation 은 검색 위치에 대한 코드입니다.
- 플래그 는 레코드가 누락되었는지 여부를 지정합니다. 현재 레코드가 누락된 후 하나 이상의 레코드가 누락된 경우 EEInfoNextRecordsMissing 이 설정됩니다. 현재 레코드가 누락되기 전에 하나 이상의 레코드가 없는 경우 EEInfoPreviousRecordsMissing 이 설정됩니다.
- NumberOfParameters는 실제 매개 변수 수를 지정합니다. 호출자가 레코드에 있는 것보다 더 많은 매개 변수에 대한 공간을 지정한 경우 이 필드에는 사용된 매개 변수 수가 포함됩니다.
- 매개 변수는 NumberOfParameters 구조체가 있는 RPC_EE_INFO_PARAM 구조체의 배열로 제공되는 실제 매개 변수입니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows XP [데스크톱 앱 | UWP 앱] |
| 지원되는 최소 서버 | Windows Server 2003 [데스크톱 앱 | UWP 앱] |
| 대상 플랫폼 | Windows |
| 헤더 | rpcasync.h(Rpc.h 포함) |
| 라이브러리 | Rpcrt4.lib |
| DLL | Rpcrt4.dll |