RpcErrorGetNextRecord 함수(rpcasync.h)

아티클
08/25/2023

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의 다른 필드는 입력에서 무시됩니다.

출력 시 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