CertSelectionGetSerializedBlob 함수(cryptuiapi.h)

CertSelectionGetSerializedBlob 함수는 CERT_SELECTUI_INPUT 구조에서 직렬화된 인증서 BLOB을 검색하는 데 사용되는 도우미 함수입니다.

구문

HRESULT CertSelectionGetSerializedBlob(
  [in]  PCERT_SELECTUI_INPUT pcsi,
  [out] void                 **ppOutBuffer,
  [out] ULONG                *pulOutBufferSize
);

매개 변수

[in] pcsi

인증서 저장소 및 인증서 컨텍스트 체인 정보를 포함하는 CERT_SELECTUI_INPUT 구조체에 대한 포인터입니다.

[out] ppOutBuffer

직렬화된 인증서 BLOB을 수신하는 버퍼에 대한 포인터의 주소입니다.

[out] pulOutBufferSize

ppOutBuffer 매개 변수가 가리키는 버퍼에서 받은 BLOB의 크기(바이트)를 수신하는 ULONG에 대한 포인터입니다.

반환 값

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

함수가 실패하면 오류를 나타내는 HRESULT 값을 반환합니다. hStore 및 prgpChain 매개 변수가 모두 NULL이 아니면 E_INVALIDARG 반환합니다. 일반적인 오류 코드 목록은 일반적인 HRESULT 값을 참조하세요.

설명

반환된 직렬화된 BLOB은 사용자가 자격 증명 선택 UI를 사용하여 인증서를 선택할 수 있도록 pvInAuthBuffer 매개 변수의 CredUIPromptForWindowsCredentials 함수에 전달됩니다.

이 함수의 ppOutBuffer 매개 변수가 가리키는 버퍼에서 반환된 BLOB에서 직렬화된 인증서는 CERT_SELECTUI_INPUT 구조체의 hStore 및 prgpChain 멤버 값에 따라 달라집니다.

hStore	prgpChain	직렬화된 인증서
NULL	NULL이 아님	prgpChain 멤버가 가리키는 인증서가 직렬화됩니다.
NULL이 아님	NULL	hStore 멤버가 지정한 인증서가 serialize됩니다.
NULL	NULL	빈 BLOB이 반환됩니다.
NULL이 아님	NULL이 아님	호출이 실패하고 함수가 E_INVALIDARG 반환합니다.

요구 사항

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