IX509CertificateRequest::GetInnerRequest 메서드(certenroll.h)

아티클
08/22/2023

GetInnerRequest 메서드는 중첩된 요청 개체를 검색합니다.

구문

HRESULT GetInnerRequest(
  [in]  InnerRequestLevel       Level,
  [out] IX509CertificateRequest **ppValue
);

매개 변수

[in] Level

검색할 데이터의 envelopment 수준을 지정하는 InnerRequestLevel 열거형의 값입니다. LevelNext 값을 사용하여 중첩된 수준 또는 LevelInnermost 값을 반복하여 가장 깊이 중첩된 요청 개체를 검색할 수 있습니다. PKCS #10 요청에 대해 LevelNext 를 지정할 수 없습니다.

[out] ppValue

중첩된 요청을 포함하는 IX509CertificateRequest 인터페이스에 대한 포인터를 수신하는 변수의 주소입니다. Type 속성을 호출하여 내부 요청 개체가 PKCS #10인지 CMC 요청인지 확인합니다. 그런 다음 QueryInterface 를 호출하여 적절한 포인터를 검색합니다.

반환 값

함수가 성공하면 함수는 S_OK 반환합니다.

함수가 실패하면 오류를 나타내는 HRESULT 값을 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다. 일반적인 오류 코드 목록은 일반적인 HRESULT 값을 참조하세요.

반환 코드/값	설명
CERTSRV_E_PROPERTY_EMPTY	LevelNext PKCS #10 요청 값을 지정했습니다.

설명

최상위 요청 개체는 PKCS #10, PKCS #7 또는 CMC 요청일 수 있습니다. 다음 규칙은 내부 요청 개체에 적용됩니다.

PKCS #10 요청에는 내부 요청 개체가 포함될 수 없습니다.
PKCS #7 요청에는 PKCS #10 내부 요청 개체만 포함될 수 있습니다.
CMC 요청에는 CMC 또는 PKCS #10 내부 요청 개체가 포함될 수 있습니다. 내부 CMC 요청을 포함하는 CMC 요청의 경우 최종 내부 PKCS #10 요청에 도달하기 전에 존재할 수 있는 중첩된 수준 수에 대한 이론적 제한이 없습니다. 즉, 최상위 CMC 요청에는 내부 CMC 요청도 포함된 내부 CMC 요청이 포함될 수 있습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	certenroll.h
DLL	CertEnroll.dll