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 |