다음을 통해 공유


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 값을 반환합니다. hStoreprgpChain 매개 변수가 모두 NULL이 아니면 E_INVALIDARG 반환합니다. 일반적인 오류 코드 목록은 일반적인 HRESULT 값을 참조하세요.

설명

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

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

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